From d2127832c6b35fde8a9ab48cec63bb34a4a2c828 Mon Sep 17 00:00:00 2001 From: Pedro S Lopez Date: Sat, 21 Oct 2023 11:37:45 -0400 Subject: [PATCH] chore: mark version v1.23.0 --- docs/Base.html | 6 +- docs/BaseAuthStrategy.html | 6 +- docs/BusinessContact.html | 6 +- docs/Buttons.html | 6 +- docs/Call.html | 6 +- docs/Chat.html | 6 +- docs/Client.html | 318 ++++- docs/Client.js.html | 243 +++- docs/ClientInfo.html | 6 +- docs/Contact.html | 6 +- docs/GroupChat.html | 144 ++- docs/GroupNotification.html | 6 +- docs/InterfaceController.html | 6 +- docs/Label.html | 6 +- docs/LegacySessionAuth.html | 6 +- docs/List.html | 6 +- docs/LocalAuth.html | 6 +- docs/LocalWebCache.html | 6 +- docs/Location.html | 46 +- docs/Message.html | 6 +- docs/MessageMedia.html | 6 +- docs/NoAuth.html | 6 +- docs/Order.html | 6 +- docs/Poll.html | 163 +++ docs/PrivateChat.html | 6 +- docs/PrivateContact.html | 6 +- docs/Product.html | 6 +- docs/Reaction.html | 6 +- docs/RemoteAuth.html | 6 +- docs/RemoteWebCache.html | 6 +- docs/Util.html | 6 +- docs/WebCache.html | 6 +- docs/authStrategies_BaseAuthStrategy.js.html | 6 +- docs/authStrategies_LegacySessionAuth.js.html | 6 +- docs/authStrategies_LocalAuth.js.html | 6 +- docs/authStrategies_NoAuth.js.html | 6 +- docs/authStrategies_RemoteAuth.js.html | 8 +- docs/global.html | 1052 ++++++++++++++- docs/index.html | 162 ++- docs/scripts/jsdoc-toc.js | 2 +- docs/structures_Base.js.html | 6 +- docs/structures_BusinessContact.js.html | 6 +- docs/structures_Buttons.js.html | 6 +- docs/structures_Call.js.html | 6 +- docs/structures_Chat.js.html | 6 +- docs/structures_ClientInfo.js.html | 6 +- docs/structures_Contact.js.html | 6 +- docs/structures_GroupChat.js.html | 204 ++- docs/structures_GroupNotification.js.html | 6 +- docs/structures_Label.js.html | 6 +- docs/structures_List.js.html | 6 +- docs/structures_Location.js.html | 42 +- docs/structures_Message.js.html | 42 +- docs/structures_MessageMedia.js.html | 6 +- docs/structures_Order.js.html | 6 +- docs/structures_Payment.js.html | 6 +- docs/structures_Poll.js.html | 98 ++ docs/structures_PrivateChat.js.html | 6 +- docs/structures_PrivateContact.js.html | 6 +- docs/structures_Product.js.html | 6 +- docs/structures_ProductMetadata.js.html | 6 +- docs/structures_Reaction.js.html | 6 +- docs/util_Constants.js.html | 8 +- docs/util_Injected.js.html | 1148 +++++++++++++++++ docs/util_InterfaceController.js.html | 6 +- docs/util_Util.js.html | 6 +- docs/webCache_LocalWebCache.js.html | 6 +- docs/webCache_RemoteWebCache.js.html | 6 +- docs/webCache_WebCache.js.html | 6 +- package.json | 2 +- 70 files changed, 3672 insertions(+), 334 deletions(-) create mode 100644 docs/Poll.html create mode 100644 docs/structures_Poll.js.html create mode 100644 docs/util_Injected.js.html diff --git a/docs/Base.html b/docs/Base.html index 0983427..c6a0cbb 100644 --- a/docs/Base.html +++ b/docs/Base.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Base + whatsapp-web.js 1.23.0 » Class: Base @@ -15,7 +15,7 @@ @@ -50,7 +50,7 @@ diff --git a/docs/BaseAuthStrategy.html b/docs/BaseAuthStrategy.html index 634f80a..80230ba 100644 --- a/docs/BaseAuthStrategy.html +++ b/docs/BaseAuthStrategy.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: BaseAuthStrategy + whatsapp-web.js 1.23.0 » Class: BaseAuthStrategy @@ -15,7 +15,7 @@ @@ -50,7 +50,7 @@ diff --git a/docs/BusinessContact.html b/docs/BusinessContact.html index 7886edb..4c243a3 100644 --- a/docs/BusinessContact.html +++ b/docs/BusinessContact.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: BusinessContact + whatsapp-web.js 1.23.0 » Class: BusinessContact @@ -15,7 +15,7 @@ @@ -326,7 +326,7 @@ diff --git a/docs/Buttons.html b/docs/Buttons.html index 09ff780..3baa235 100644 --- a/docs/Buttons.html +++ b/docs/Buttons.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Buttons + whatsapp-web.js 1.23.0 » Class: Buttons @@ -15,7 +15,7 @@ @@ -234,7 +234,7 @@ Returns: [{ buttonId:'customId',buttonText:{'displayText':&# diff --git a/docs/Call.html b/docs/Call.html index 57fbb18..b7489d0 100644 --- a/docs/Call.html +++ b/docs/Call.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Call + whatsapp-web.js 1.23.0 » Class: Call @@ -15,7 +15,7 @@ @@ -168,7 +168,7 @@ diff --git a/docs/Chat.html b/docs/Chat.html index 4229e99..706ea57 100644 --- a/docs/Chat.html +++ b/docs/Chat.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Chat + whatsapp-web.js 1.23.0 » Class: Chat @@ -15,7 +15,7 @@ @@ -545,7 +545,7 @@ diff --git a/docs/Client.html b/docs/Client.html index d63907a..46398b9 100644 --- a/docs/Client.html +++ b/docs/Client.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Client + whatsapp-web.js 1.23.0 » Class: Client @@ -15,7 +15,7 @@ @@ -26,7 +26,7 @@
class

Client

-

Source: Client.js:55

+

Source: Client.js:56

Starting point for interacting with the WhatsApp Web API

@@ -64,10 +64,13 @@
addOrRemoveLabels(labelIds, chatIds)
+
approveGroupMembershipRequests(groupId, options)
+
+
archiveChat()
-
createGroup(name, participants)
+
createGroup(title, participants, options)
deleteProfilePicture()
@@ -110,6 +113,9 @@
getFormattedNumber(number)
+
getGroupMembershipRequests(groupId)
+
+
getInviteInfo(inviteCode)
@@ -153,6 +159,9 @@
pinChat()
+
rejectGroupMembershipRequests(groupId, options)
+
+
resetState()
@@ -235,6 +244,9 @@
group_leave
+
group_membership_request
+
+
group_update
@@ -247,13 +259,13 @@
message
-
message_ack
-
-
+
message_ack
+
+
message_create
@@ -541,6 +553,7 @@
Client#event:change_state
Client#event:contact_changed
Client#event:group_admin_changed
+
Client#event:group_membership_request
@@ -683,17 +696,8 @@
async
-

archiveChat() → boolean

-

Enables and returns the archive state of the Chat

-
-
Returns
-
-

boolean 

-
-
-
async
-

createGroup(name, participants) → (Object, string, or Object with string properties)

-

Create a new group

+

approveGroupMembershipRequests(groupId, options) → Promise containing Array of MembershipRequestActionResult

+

Approves membership requests if any

Parameters

@@ -708,7 +712,7 @@ @@ -740,18 +744,85 @@
Returns
-

Object  -

createRes

+

Promise containing Array of MembershipRequestActionResult  +

Returns an array of requester IDs whose membership requests were approved and an error for each requester, if any occurred during the operation. If there are no requests, an empty array will be returned

+
+
async
+

archiveChat() → boolean

+

Enables and returns the archive state of the Chat

+
+
Returns
-

string  -

createRes.gid - ID for the group that was just created

-

+

boolean 

+
+
async
+

createGroup(title, participants, options) → Promise containing (CreateGroupResult or string)

+

Creates a new group

+
+

Parameters

+
-

name

+

groupId

string

@@ -717,21 +721,21 @@

 

 -

group title

+

The group ID to get the membership request for
-

participants

+

options

 -

Array of (Contact or string)

+

MembershipRequestActionOptions

 

 -

an array of Contacts or contact IDs to add to the group

+

Options for performing a membership request action
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

title

+ 		+

string

+ 		+

 

+ 		+

Group title

+
+

participants

+ 		+

(string, Contact, Array of (Contact or string), or undefined)

+ 		+

 

+ 		+

A single Contact object or an ID as a string or an array of Contact objects or contact IDs to add to the group

+
+

options

+ 		+

CreateGroupOptions

+ 		+

 

+ 		+

An object that handles options for group creation

+
+
+
+
Returns
-

Object with string properties  -

createRes.missingParticipants - participants that were not added to the group. Keys represent the ID for participant that was not added and its value is a status code that represents the reason why participant could not be added. This is usually 403 if the user's privacy settings don't allow you to add them to groups.

+

Promise containing (CreateGroupResult or string)  +

Object with resulting data or an error message as a string

@@ -1061,6 +1132,46 @@
async
+

getGroupMembershipRequests(groupId) → Promise containing Array of GroupMembershipRequest

+

Gets an array of membership requests

+
+

Parameter

+ + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

groupId

+ 		+

string

+ 		+

 

+ 		+

The ID of a group to get membership requests for

+
+
+
+
Returns
+
+

Promise containing Array of GroupMembershipRequest  +

An array of membership requests

+

+
+
+
async

getInviteInfo(inviteCode) → Promise containing object

Returns an object with information about the invite code's group

@@ -1383,6 +1494,60 @@
async
+

rejectGroupMembershipRequests(groupId, options) → Promise containing Array of MembershipRequestActionResult

+

Rejects membership requests if any

+
+

Parameters

+ + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

groupId

+ 		+

string

+ 		+

 

+ 		+

The group ID to get the membership request for

+
+

options

+ 		+

MembershipRequestActionOptions

+ 		+

 

+ 		+

Options for performing a membership request action

+
+
+
+
Returns
+
+

Promise containing Array of MembershipRequestActionResult  +

Returns an array of requester IDs whose membership requests were rejected and an error for each requester, if any occurred during the operation. If there are no requests, an empty array will be returned

+

+
+
+
async

resetState()

Force reset of connection state for the client

@@ -1522,7 +1687,7 @@

content

-

(string, MessageMedia, Location, Contact, Array of Contact, Buttons, or List)

+

(string, MessageMedia, Location, Poll, Contact, Array of Contact, Buttons, or List)

 

@@ -2215,6 +2380,95 @@
+

group_membership_request

+

Emitted when some user requested to join the group + that has the membership approval mode turned on

+
+

Parameters

+ + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

notification

+ 		+

GroupNotification

+ 		+

 

+ 		+

GroupNotification with more information about the action

+

Values in notification have the following properties:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

chatId

+ 		+

string

+ 		+

 

+ 		+

The group ID the request was made for

+
+

author

+ 		+

string

+ 		+

 

+ 		+

The user ID that made a request

+
+

timestamp

+ 		+

number

+ 		+

 

+ 		+

The timestamp the request was made at

+
+
+
+
+

group_update

Emitted when group settings are updated, such as subject, description or picture.

@@ -2911,7 +3165,7 @@
diff --git a/docs/Client.js.html b/docs/Client.js.html index 0e4fcc8..0fe7276 100644 --- a/docs/Client.js.html +++ b/docs/Client.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: Client.js + whatsapp-web.js 1.23.0 » Source: Client.js @@ -15,7 +15,7 @@ @@ -42,7 +42,7 @@ const { ExposeStore, LoadUtils } = require('./util/Injected'); const ChatFactory = require('./factories/ChatFactory'); const ContactFactory = require('./factories/ContactFactory'); const WebCacheFactory = require('./webCache/WebCacheFactory'); -const { ClientInfo, Message, MessageMedia, Contact, Location, GroupNotification, Label, Call, Buttons, List, Reaction, Chat } = require('./structures'); +const { ClientInfo, Message, MessageMedia, Contact, Location, Poll, GroupNotification, Label, Call, Buttons, List, Reaction } = require('./structures'); const LegacySessionAuth = require('./authStrategies/LegacySessionAuth'); const NoAuth = require('./authStrategies/NoAuth'); @@ -82,6 +82,7 @@ const NoAuth = require('./authStrategies/NoAuth'); * @fires Client#change_state * @fires Client#contact_changed * @fires Client#group_admin_changed + * @fires Client#group_membership_request */ class Client extends EventEmitter { constructor(options = {}) { @@ -203,7 +204,7 @@ class Client extends EventEmitter { } ); - const INTRO_IMG_SELECTOR = '[data-testid="intro-md-beta-logo-dark"], [data-testid="intro-md-beta-logo-light"], [data-asset-intro-image-light="true"], [data-asset-intro-image-dark="true"]'; + const INTRO_IMG_SELECTOR = '[data-icon=\'search\']'; const INTRO_QRCODE_SELECTOR = 'div[data-ref] canvas'; // Checks which selector appears first @@ -316,13 +317,13 @@ class Client extends EventEmitter { */ window.compareWwebVersions = (lOperand, operator, rOperand) => { if (!['>', '>=', '<', '<=', '='].includes(operator)) { - throw class _ extends Error { + throw new class _ extends Error { constructor(m) { super(m); this.name = 'CompareWwebVersionsError'; } }('Invalid comparison operator is provided'); } if (typeof lOperand !== 'string' || typeof rOperand !== 'string') { - throw class _ extends Error { + throw new class _ extends Error { constructor(m) { super(m); this.name = 'CompareWwebVersionsError'; } }('A non-string WWeb version type is provided'); } @@ -410,6 +411,17 @@ class Client extends EventEmitter { * @param {GroupNotification} notification GroupNotification with more information about the action */ this.emit(Events.GROUP_ADMIN_CHANGED, notification); + } else if (msg.subtype === 'created_membership_requests') { + /** + * Emitted when some user requested to join the group + * that has the membership approval mode turned on + * @event Client#group_membership_request + * @param {GroupNotification} notification GroupNotification with more information about the action + * @param {string} notification.chatId The group ID the request was made for + * @param {string} notification.author The user ID that made a request + * @param {number} notification.timestamp The timestamp the request was made at + */ + this.emit(Events.GROUP_MEMBERSHIP_REQUEST, notification); } else { /** * Emitted when group settings are updated, such as subject, description or picture. @@ -639,16 +651,20 @@ class Client extends EventEmitter { } }); - await page.exposeFunction('onRemoveChatEvent', (chat) => { + await page.exposeFunction('onRemoveChatEvent', async (chat) => { + const _chat = await this.getChatById(chat.id); + /** * Emitted when a chat is removed * @event Client#chat_removed * @param {Chat} chat */ - this.emit(Events.CHAT_REMOVED, new Chat(this, chat)); + this.emit(Events.CHAT_REMOVED, _chat); }); - await page.exposeFunction('onArchiveChatEvent', (chat, currState, prevState) => { + await page.exposeFunction('onArchiveChatEvent', async (chat, currState, prevState) => { + const _chat = await this.getChatById(chat.id); + /** * Emitted when a chat is archived/unarchived * @event Client#chat_archived @@ -656,7 +672,7 @@ class Client extends EventEmitter { * @param {boolean} currState * @param {boolean} prevState */ - this.emit(Events.CHAT_ARCHIVED, new Chat(this, chat), currState, prevState); + this.emit(Events.CHAT_ARCHIVED, _chat, currState, prevState); }); await page.exposeFunction('onEditMessageEvent', (msg, newBody, prevBody) => { @@ -816,7 +832,7 @@ class Client extends EventEmitter { * Message options. * @typedef {Object} MessageSendOptions * @property {boolean} [linkPreview=true] - Show links preview. Has no effect on multi-device accounts. - * @property {boolean} [sendAudioAsVoice=false] - Send audio as voice message + * @property {boolean} [sendAudioAsVoice=false] - Send audio as voice message with a generated waveform * @property {boolean} [sendVideoAsGif=false] - Send video as gif * @property {boolean} [sendMediaAsSticker=false] - Send media as a sticker * @property {boolean} [sendMediaAsDocument=false] - Send media as a document @@ -835,7 +851,7 @@ class Client extends EventEmitter { /** * Send a message to a specific chatId * @param {string} chatId - * @param {string|MessageMedia|Location|Contact|Array<Contact>|Buttons|List} content + * @param {string|MessageMedia|Location|Poll|Contact|Array<Contact>|Buttons|List} content * @param {MessageSendOptions} [options] - Options used when sending the message * * @returns {Promise<Message>} Message that was just sent @@ -872,6 +888,9 @@ class Client extends EventEmitter { } else if (content instanceof Location) { internalOptions.location = content; content = ''; + } else if (content instanceof Poll) { + internalOptions.poll = content; + content = ''; } else if (content instanceof Contact) { internalOptions.contactCard = content.id._serialized; content = ''; @@ -1006,7 +1025,7 @@ class Client extends EventEmitter { */ async getInviteInfo(inviteCode) { return await this.pupPage.evaluate(inviteCode => { - return window.Store.InviteInfo.queryGroupInvite(inviteCode); + return window.Store.GroupInvite.queryGroupInvite(inviteCode); }, inviteCode); } @@ -1017,7 +1036,7 @@ class Client extends EventEmitter { */ async acceptInvite(inviteCode) { const res = await this.pupPage.evaluate(async inviteCode => { - return await window.Store.Invite.joinGroupViaInvite(inviteCode); + return await window.Store.GroupInvite.joinGroupViaInvite(inviteCode); }, inviteCode); return res.gid._serialized; @@ -1034,7 +1053,7 @@ class Client extends EventEmitter { return this.pupPage.evaluate(async inviteInfo => { let { groupId, fromId, inviteCode, inviteCodeExp } = inviteInfo; let userWid = window.Store.WidFactory.createWid(fromId); - return await window.Store.JoinInviteV4.joinGroupViaInviteV4(inviteCode, String(inviteCodeExp), groupId, userWid); + return await window.Store.GroupInviteV4.joinGroupViaInviteV4(inviteCode, String(inviteCodeExp), groupId, userWid); }, inviteInfo); } @@ -1310,35 +1329,116 @@ class Client extends EventEmitter { } /** - * Create a new group - * @param {string} name group title - * @param {Array<Contact|string>} participants an array of Contacts or contact IDs to add to the group - * @returns {Object} createRes - * @returns {string} createRes.gid - ID for the group that was just created - * @returns {Object.<string,string>} createRes.missingParticipants - participants that were not added to the group. Keys represent the ID for participant that was not added and its value is a status code that represents the reason why participant could not be added. This is usually 403 if the user's privacy settings don't allow you to add them to groups. + * An object that represents the result for a participant added to a group + * @typedef {Object} ParticipantResult + * @property {number} statusCode The status code of the result + * @property {string} message The result message + * @property {boolean} isGroupCreator Indicates if the participant is a group creator + * @property {boolean} isInviteV4Sent Indicates if the inviteV4 was sent to the participant */ - async createGroup(name, participants) { - if (!Array.isArray(participants) || participants.length == 0) { - throw 'You need to add at least one other participant to the group'; - } - if (participants.every(c => c instanceof Contact)) { - participants = participants.map(c => c.id._serialized); - } + /** + * An object that handles the result for {@link createGroup} method + * @typedef {Object} CreateGroupResult + * @property {string} title A group title + * @property {Object} gid An object that handles the newly created group ID + * @property {string} gid.server + * @property {string} gid.user + * @property {string} gid._serialized + * @property {Object.<string, ParticipantResult>} participants An object that handles the result value for each added to the group participant + */ - const createRes = await this.pupPage.evaluate(async (name, participantIds) => { - const participantWIDs = participantIds.map(p => window.Store.WidFactory.createWid(p)); - return await window.Store.GroupUtils.createGroup(name, participantWIDs, 0); - }, name, participants); + /** + * An object that handles options for group creation + * @typedef {Object} CreateGroupOptions + * @property {number} [messageTimer = 0] The number of seconds for the messages to disappear in the group (0 by default, won't take an effect if the group is been creating with myself only) + * @property {string|undefined} parentGroupId The ID of a parent community group to link the newly created group with (won't take an effect if the group is been creating with myself only) + * @property {boolean} [autoSendInviteV4 = true] If true, the inviteV4 will be sent to those participants who have restricted others from being automatically added to groups, otherwise the inviteV4 won't be sent (true by default) + * @property {string} [comment = ''] The comment to be added to an inviteV4 (empty string by default) + */ - const missingParticipants = createRes.participants.reduce(((missing, c) => { - const id = c.wid._serialized; - const statusCode = c.error ? c.error.toString() : '200'; - if (statusCode != 200) return Object.assign(missing, { [id]: statusCode }); - return missing; - }), {}); + /** + * Creates a new group + * @param {string} title Group title + * @param {string|Contact|Array<Contact|string>|undefined} participants A single Contact object or an ID as a string or an array of Contact objects or contact IDs to add to the group + * @param {CreateGroupOptions} options An object that handles options for group creation + * @returns {Promise<CreateGroupResult|string>} Object with resulting data or an error message as a string + */ + async createGroup(title, participants = [], options = {}) { + !Array.isArray(participants) && (participants = [participants]); + participants.map(p => (p instanceof Contact) ? p.id._serialized : p); - return { gid: createRes.wid, missingParticipants }; + return await this.pupPage.evaluate(async (title, participants, options) => { + const { messageTimer = 0, parentGroupId, autoSendInviteV4 = true, comment = '' } = options; + const participantData = {}, participantWids = [], failedParticipants = []; + let createGroupResult, parentGroupWid; + + const addParticipantResultCodes = { + default: 'An unknown error occupied while adding a participant', + 200: 'The participant was added successfully', + 403: 'The participant can be added by sending private invitation only', + 404: 'The phone number is not registered on WhatsApp' + }; + + for (const participant of participants) { + const pWid = window.Store.WidFactory.createWid(participant); + if ((await window.Store.QueryExist(pWid))?.wid) participantWids.push(pWid); + else failedParticipants.push(participant); + } + + parentGroupId && (parentGroupWid = window.Store.WidFactory.createWid(parentGroupId)); + + try { + createGroupResult = await window.Store.GroupUtils.createGroup( + title, + participantWids, + messageTimer, + parentGroupWid + ); + } catch (err) { + return 'CreateGroupError: An unknown error occupied while creating a group'; + } + + for (const participant of createGroupResult.participants) { + let isInviteV4Sent = false; + const participantId = participant.wid._serialized; + const statusCode = participant.error ?? 200; + + if (autoSendInviteV4 && statusCode === 403) { + window.Store.ContactCollection.gadd(participant.wid, { silent: true }); + const addParticipantResult = await window.Store.GroupInviteV4.sendGroupInviteMessage( + await window.Store.Chat.find(participant.wid), + createGroupResult.wid._serialized, + createGroupResult.subject, + participant.invite_code, + participant.invite_code_exp, + comment, + await window.WWebJS.getProfilePicThumbToBase64(createGroupResult.wid) + ); + isInviteV4Sent = window.compareWwebVersions(window.Debug.VERSION, '<', '2.2335.6') + ? addParticipantResult === 'OK' + : addParticipantResult.messageSendResult === 'OK'; + } + + participantData[participantId] = { + statusCode: statusCode, + message: addParticipantResultCodes[statusCode] || addParticipantResultCodes.default, + isGroupCreator: participant.type === 'superadmin', + isInviteV4Sent: isInviteV4Sent + }; + } + + for (const f of failedParticipants) { + participantData[f] = { + statusCode: 404, + message: addParticipantResultCodes[404], + isGroupCreator: false, + isInviteV4Sent: false + }; + } + + return { title: title, gid: createGroupResult.wid, participants: participantData }; + }, title, participants, options); } /** @@ -1465,6 +1565,69 @@ class Client extends EventEmitter { return await window.Store.Label.addOrRemoveLabels(actions, chats); }, labelIds, chatIds); } + + /** + * An object that handles the information about the group membership request + * @typedef {Object} GroupMembershipRequest + * @property {Object} id The wid of a user who requests to enter the group + * @property {Object} addedBy The wid of a user who created that request + * @property {Object|null} parentGroupId The wid of a community parent group to which the current group is linked + * @property {string} requestMethod The method used to create the request: NonAdminAdd/InviteLink/LinkedGroupJoin + * @property {number} t The timestamp the request was created at + */ + + /** + * Gets an array of membership requests + * @param {string} groupId The ID of a group to get membership requests for + * @returns {Promise<Array<GroupMembershipRequest>>} An array of membership requests + */ + async getGroupMembershipRequests(groupId) { + return await this.pupPage.evaluate(async (gropId) => { + const groupWid = window.Store.WidFactory.createWid(gropId); + return await window.Store.MembershipRequestUtils.getMembershipApprovalRequests(groupWid); + }, groupId); + } + + /** + * An object that handles the result for membership request action + * @typedef {Object} MembershipRequestActionResult + * @property {string} requesterId User ID whos membership request was approved/rejected + * @property {number|undefined} error An error code that occurred during the operation for the participant + * @property {string} message A message with a result of membership request action + */ + + /** + * An object that handles options for {@link approveGroupMembershipRequests} and {@link rejectGroupMembershipRequests} methods + * @typedef {Object} MembershipRequestActionOptions + * @property {Array<string>|string|null} requesterIds User ID/s who requested to join the group, if no value is provided, the method will search for all membership requests for that group + * @property {Array<number>|number|null} sleep The number of milliseconds to wait before performing an operation for the next requester. If it is an array, a random sleep time between the sleep[0] and sleep[1] values will be added (the difference must be >=100 ms, otherwise, a random sleep time between sleep[1] and sleep[1] + 100 will be added). If sleep is a number, a sleep time equal to its value will be added. By default, sleep is an array with a value of [250, 500] + */ + + /** + * Approves membership requests if any + * @param {string} groupId The group ID to get the membership request for + * @param {MembershipRequestActionOptions} options Options for performing a membership request action + * @returns {Promise<Array<MembershipRequestActionResult>>} Returns an array of requester IDs whose membership requests were approved and an error for each requester, if any occurred during the operation. If there are no requests, an empty array will be returned + */ + async approveGroupMembershipRequests(groupId, options = {}) { + return await this.pupPage.evaluate(async (groupId, options) => { + const { requesterIds = null, sleep = [250, 500] } = options; + return await window.WWebJS.membershipRequestAction(groupId, 'Approve', requesterIds, sleep); + }, groupId, options); + } + + /** + * Rejects membership requests if any + * @param {string} groupId The group ID to get the membership request for + * @param {MembershipRequestActionOptions} options Options for performing a membership request action + * @returns {Promise<Array<MembershipRequestActionResult>>} Returns an array of requester IDs whose membership requests were rejected and an error for each requester, if any occurred during the operation. If there are no requests, an empty array will be returned + */ + async rejectGroupMembershipRequests(groupId, options = {}) { + return await this.pupPage.evaluate(async (groupId, options) => { + const { requesterIds = null, sleep = [250, 500] } = options; + return await window.WWebJS.membershipRequestAction(groupId, 'Reject', requesterIds, sleep); + }, groupId, options); + } } module.exports = Client; @@ -1478,7 +1641,7 @@ module.exports = Client;
diff --git a/docs/ClientInfo.html b/docs/ClientInfo.html index cbf573d..015f210 100644 --- a/docs/ClientInfo.html +++ b/docs/ClientInfo.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: ClientInfo + whatsapp-web.js 1.23.0 » Class: ClientInfo @@ -15,7 +15,7 @@ @@ -242,7 +242,7 @@
diff --git a/docs/Contact.html b/docs/Contact.html index 2e41707..5a9f658 100644 --- a/docs/Contact.html +++ b/docs/Contact.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Contact + whatsapp-web.js 1.23.0 » Class: Contact @@ -15,7 +15,7 @@ @@ -293,7 +293,7 @@
diff --git a/docs/GroupChat.html b/docs/GroupChat.html index fea1792..37e2024 100644 --- a/docs/GroupChat.html +++ b/docs/GroupChat.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: GroupChat + whatsapp-web.js 1.23.0 » Class: GroupChat @@ -15,7 +15,7 @@ @@ -101,7 +101,10 @@
-
addParticipants(participantIds)
+
addParticipants(participantIds, options)
+
+
+
approveGroupMembershipRequests(options)
archive()
@@ -131,13 +134,16 @@
getContact()
-
getInviteCode()
+
getGroupMembershipRequests()
+
getInviteCode()
+
+
getLabels()
@@ -156,6 +162,9 @@
promoteParticipants(participantIds)
+
rejectGroupMembershipRequests(options)
+
+
removeParticipants(participantIds)
@@ -168,13 +177,13 @@
sendSeen()
-
sendStateRecording()
-
-
+
sendStateRecording()
+
+
sendStateTyping()
@@ -318,10 +327,10 @@

Methods

async
-

addParticipants(participantIds) → Promise containing Object

+

addParticipants(participantIds, options) → Promise containing (Object with AddParticipantsResult properties or string)

Adds a list of participants by ID to the group

-

Parameter

+

Parameters

@@ -337,7 +346,7 @@

participantIds

+ + + + + +
-

Array of string

+

(string or Array of string)

 

@@ -345,13 +354,69 @@
+

options

+ 		+

AddParticipnatsOptions

+ 		+

 

+ 		+

An object thay handles options for adding participants

+
Returns
-

Promise containing Object 

+

Promise containing (Object with AddParticipantsResult properties or string)  +

Returns an object with the resulting data or an error message as a string

+

+
+
+
async
+

approveGroupMembershipRequests(options) → Promise containing Array of MembershipRequestActionResult

+

Approves membership requests if any

+
+

Parameter

+ + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

options

+ 		+

MembershipRequestActionOptions

+ 		+

 

+ 		+

Options for performing a membership request action

+
+
+
+
Returns
+
+

Promise containing Array of MembershipRequestActionResult  +

Returns an array of requester IDs whose membership requests were approved and an error for each requester, if any occurred during the operation. If there are no requests, an empty array will be returned

+

async
@@ -566,6 +631,17 @@
async
+

getGroupMembershipRequests() → Promise containing Array of GroupMembershipRequest

+

Gets an array of membership requests

+
+
Returns
+
+

Promise containing Array of GroupMembershipRequest  +

An array of membership requests

+

+
+
+
async

getInviteCode() → Promise containing string

Gets the invite code for a specific group

@@ -689,7 +765,47 @@
async
-

removeParticipants(participantIds) → Promise containing Object

+

rejectGroupMembershipRequests(options) → Promise containing Array of MembershipRequestActionResult

+

Rejects membership requests if any

+
+

Parameter

+ + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

options

+ 		+

MembershipRequestActionOptions

+ 		+

 

+ 		+

Options for performing a membership request action

+
+
+
+
Returns
+
+

Promise containing Array of MembershipRequestActionResult  +

Returns an array of requester IDs whose membership requests were rejected and an error for each requester, if any occurred during the operation. If there are no requests, an empty array will be returned

+

+
+
+
async
+

removeParticipants(participantIds) → Promise containing {status: number}

Removes a list of participants by ID to the group

Parameter

@@ -722,7 +838,7 @@
Returns
-

Promise containing Object 

+

Promise containing {status: number} 

async
@@ -1047,7 +1163,7 @@
diff --git a/docs/GroupNotification.html b/docs/GroupNotification.html index 0fd3692..a66ec93 100644 --- a/docs/GroupNotification.html +++ b/docs/GroupNotification.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: GroupNotification + whatsapp-web.js 1.23.0 » Class: GroupNotification @@ -15,7 +15,7 @@ @@ -233,7 +233,7 @@
diff --git a/docs/InterfaceController.html b/docs/InterfaceController.html index fa7fdc9..262c122 100644 --- a/docs/InterfaceController.html +++ b/docs/InterfaceController.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: InterfaceController + whatsapp-web.js 1.23.0 » Class: InterfaceController @@ -15,7 +15,7 @@ @@ -382,7 +382,7 @@
diff --git a/docs/Label.html b/docs/Label.html index 7f31ab7..8b3219a 100644 --- a/docs/Label.html +++ b/docs/Label.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Label + whatsapp-web.js 1.23.0 » Class: Label @@ -15,7 +15,7 @@ @@ -163,7 +163,7 @@
diff --git a/docs/LegacySessionAuth.html b/docs/LegacySessionAuth.html index 8e677da..4cabeca 100644 --- a/docs/LegacySessionAuth.html +++ b/docs/LegacySessionAuth.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: LegacySessionAuth + whatsapp-web.js 1.23.0 » Class: LegacySessionAuth @@ -15,7 +15,7 @@ @@ -173,7 +173,7 @@
diff --git a/docs/List.html b/docs/List.html index 1ae6f8b..9135bdf 100644 --- a/docs/List.html +++ b/docs/List.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: List + whatsapp-web.js 1.23.0 » Class: List @@ -15,7 +15,7 @@ @@ -256,7 +256,7 @@ Returns: [{'title':'sectionTitle','rows':[{'r
diff --git a/docs/LocalAuth.html b/docs/LocalAuth.html index 61fa324..81f524f 100644 --- a/docs/LocalAuth.html +++ b/docs/LocalAuth.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: LocalAuth + whatsapp-web.js 1.23.0 » Class: LocalAuth @@ -15,7 +15,7 @@ @@ -120,7 +120,7 @@
diff --git a/docs/LocalWebCache.html b/docs/LocalWebCache.html index 1921140..bd21a4d 100644 --- a/docs/LocalWebCache.html +++ b/docs/LocalWebCache.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: LocalWebCache + whatsapp-web.js 1.23.0 » Class: LocalWebCache @@ -15,7 +15,7 @@ @@ -120,7 +120,7 @@
diff --git a/docs/Location.html b/docs/Location.html index d7f2fa6..588d576 100644 --- a/docs/Location.html +++ b/docs/Location.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Location + whatsapp-web.js 1.23.0 » Class: Location @@ -15,7 +15,7 @@ @@ -26,7 +26,7 @@
class

Location

-

Source: structures/Location.js:6

+

Source: structures/Location.js:14

Location information

@@ -39,6 +39,9 @@
+
address
+
+
description
@@ -49,11 +52,17 @@
latitude
+
longitude
+
+
-
longitude
+
name
+
+
+
url
@@ -62,7 +71,7 @@
-

new Location(latitude, longitude, description)

+

new Location(latitude, longitude[, options])

Parameters

@@ -103,16 +112,16 @@ @@ -124,9 +133,14 @@

Properties

+

address +  (string or undefined)

+

Location address

+
+

description -  nullable string

-

Name for the location

+  (string or undefined) +

Location full description

latitude @@ -139,6 +153,16 @@

Location longitude

+

name +  (string or undefined)

+

Name for the location

+
+
+

url +  (string or undefined)

+

URL address to be shown within a location message

+
+

@@ -149,7 +173,7 @@
diff --git a/docs/Message.html b/docs/Message.html index 5f3eab1..64420ec 100644 --- a/docs/Message.html +++ b/docs/Message.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Message + whatsapp-web.js 1.23.0 » Class: Message @@ -15,7 +15,7 @@ @@ -724,7 +724,7 @@
diff --git a/docs/MessageMedia.html b/docs/MessageMedia.html index 8580cbb..4b58ccb 100644 --- a/docs/MessageMedia.html +++ b/docs/MessageMedia.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: MessageMedia + whatsapp-web.js 1.23.0 » Class: MessageMedia @@ -15,7 +15,7 @@ @@ -364,7 +364,7 @@
diff --git a/docs/NoAuth.html b/docs/NoAuth.html index a7f4981..36f7a61 100644 --- a/docs/NoAuth.html +++ b/docs/NoAuth.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: NoAuth + whatsapp-web.js 1.23.0 » Class: NoAuth @@ -15,7 +15,7 @@ @@ -51,7 +51,7 @@
diff --git a/docs/Order.html b/docs/Order.html index 0a09682..ac40b6c 100644 --- a/docs/Order.html +++ b/docs/Order.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Order + whatsapp-web.js 1.23.0 » Class: Order @@ -15,7 +15,7 @@ @@ -102,7 +102,7 @@
diff --git a/docs/Poll.html b/docs/Poll.html new file mode 100644 index 0000000..ba996d6 --- /dev/null +++ b/docs/Poll.html @@ -0,0 +1,163 @@ + + + + + + + whatsapp-web.js 1.23.0 » Class: Poll + + + + + + + + +
+
+
+
+
+
class
+

Poll

+

Source: structures/Poll.js:11

+
+

Represents a Poll on WhatsApp

+
+
+
+
+
+
+

Properties

+
+
+
+
options
+
+
+
+
+
+
+
pollName
+
+
+
+
+
+
+
pollOptions
+
+
+
+
+
+
+
+
+

new Poll(pollName, pollOptions, options)

+
+

Parameters

+
-

description

+

options

 

 -

 

+

Yes

 -

Value can be null.

+

Location send options
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

pollName

+ 		+

 

+ 		+

 

+ 		+
+

pollOptions

+ 		+

 

+ 		+

 

+ 		+
+

options

+ 		+

 

+ 		+

 

+ 		+
+
+
+
+
+
+

Properties

+
+

options +  PollSendOptions

+

The send options for the poll

+
+
+

pollName +  string

+

The name of the poll

+
+
+

pollOptions +  Array of {name: string, localId: number}

+

The array of poll options

+
+
+
+
+
+
+ +
+ +
+ +
+ + + + + + + + + \ No newline at end of file diff --git a/docs/PrivateChat.html b/docs/PrivateChat.html index 4d6e885..d708426 100644 --- a/docs/PrivateChat.html +++ b/docs/PrivateChat.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: PrivateChat + whatsapp-web.js 1.23.0 » Class: PrivateChat @@ -15,7 +15,7 @@ @@ -583,7 +583,7 @@
diff --git a/docs/PrivateContact.html b/docs/PrivateContact.html index 6a19bca..a1c8aeb 100644 --- a/docs/PrivateContact.html +++ b/docs/PrivateContact.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: PrivateContact + whatsapp-web.js 1.23.0 » Class: PrivateContact @@ -15,7 +15,7 @@ @@ -319,7 +319,7 @@
diff --git a/docs/Product.html b/docs/Product.html index 6779ea3..510c8aa 100644 --- a/docs/Product.html +++ b/docs/Product.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Product + whatsapp-web.js 1.23.0 » Class: Product @@ -15,7 +15,7 @@ @@ -127,7 +127,7 @@
diff --git a/docs/Reaction.html b/docs/Reaction.html index 2ee190d..510a722 100644 --- a/docs/Reaction.html +++ b/docs/Reaction.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Reaction + whatsapp-web.js 1.23.0 » Class: Reaction @@ -15,7 +15,7 @@ @@ -144,7 +144,7 @@
diff --git a/docs/RemoteAuth.html b/docs/RemoteAuth.html index 68f26c2..d55ea49 100644 --- a/docs/RemoteAuth.html +++ b/docs/RemoteAuth.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: RemoteAuth + whatsapp-web.js 1.23.0 » Class: RemoteAuth @@ -15,7 +15,7 @@ @@ -148,7 +148,7 @@
diff --git a/docs/RemoteWebCache.html b/docs/RemoteWebCache.html index 3ddf4f3..b139248 100644 --- a/docs/RemoteWebCache.html +++ b/docs/RemoteWebCache.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: RemoteWebCache + whatsapp-web.js 1.23.0 » Class: RemoteWebCache @@ -15,7 +15,7 @@ @@ -120,7 +120,7 @@
diff --git a/docs/Util.html b/docs/Util.html index 2b19d4b..9208ce1 100644 --- a/docs/Util.html +++ b/docs/Util.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: Util + whatsapp-web.js 1.23.0 » Class: Util @@ -15,7 +15,7 @@ @@ -243,7 +243,7 @@
diff --git a/docs/WebCache.html b/docs/WebCache.html index 3e7eebc..3acfa73 100644 --- a/docs/WebCache.html +++ b/docs/WebCache.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Class: WebCache + whatsapp-web.js 1.23.0 » Class: WebCache @@ -15,7 +15,7 @@ @@ -50,7 +50,7 @@
diff --git a/docs/authStrategies_BaseAuthStrategy.js.html b/docs/authStrategies_BaseAuthStrategy.js.html index 094a190..b978fd0 100644 --- a/docs/authStrategies_BaseAuthStrategy.js.html +++ b/docs/authStrategies_BaseAuthStrategy.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: authStrategies/BaseAuthStrategy.js + whatsapp-web.js 1.23.0 » Source: authStrategies/BaseAuthStrategy.js @@ -15,7 +15,7 @@ @@ -65,7 +65,7 @@ module.exports = BaseAuthStrategy;
diff --git a/docs/authStrategies_LegacySessionAuth.js.html b/docs/authStrategies_LegacySessionAuth.js.html index c12c031..28c10c4 100644 --- a/docs/authStrategies_LegacySessionAuth.js.html +++ b/docs/authStrategies_LegacySessionAuth.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: authStrategies/LegacySessionAuth.js + whatsapp-web.js 1.23.0 » Source: authStrategies/LegacySessionAuth.js @@ -15,7 +15,7 @@ @@ -111,7 +111,7 @@ module.exports = LegacySessionAuth;
diff --git a/docs/authStrategies_LocalAuth.js.html b/docs/authStrategies_LocalAuth.js.html index ec9940e..ab86187 100644 --- a/docs/authStrategies_LocalAuth.js.html +++ b/docs/authStrategies_LocalAuth.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: authStrategies/LocalAuth.js + whatsapp-web.js 1.23.0 » Source: authStrategies/LocalAuth.js @@ -15,7 +15,7 @@ @@ -92,7 +92,7 @@ module.exports = LocalAuth;
diff --git a/docs/authStrategies_NoAuth.js.html b/docs/authStrategies_NoAuth.js.html index 7c7e4e3..60e4ecb 100644 --- a/docs/authStrategies_NoAuth.js.html +++ b/docs/authStrategies_NoAuth.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: authStrategies/NoAuth.js + whatsapp-web.js 1.23.0 » Source: authStrategies/NoAuth.js @@ -15,7 +15,7 @@ @@ -50,7 +50,7 @@ module.exports = NoAuth;
diff --git a/docs/authStrategies_RemoteAuth.js.html b/docs/authStrategies_RemoteAuth.js.html index 2a3c441..09bd8b2 100644 --- a/docs/authStrategies_RemoteAuth.js.html +++ b/docs/authStrategies_RemoteAuth.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: authStrategies/RemoteAuth.js + whatsapp-web.js 1.23.0 » Source: authStrategies/RemoteAuth.js @@ -15,7 +15,7 @@ @@ -72,7 +72,7 @@ class RemoteAuth extends BaseAuthStrategy { this.clientId = clientId; this.backupSyncIntervalMs = backupSyncIntervalMs; this.dataPath = path.resolve(dataPath || './.wwebjs_auth/'); - this.tempDir = `${this.dataPath}/wwebjs_temp_session`; + this.tempDir = `${this.dataPath}/wwebjs_temp_session_${this.clientId}`; this.requiredDirs = ['Default', 'IndexedDB', 'Local Storage']; /* => Required Files & Dirs in WWebJS to restore session */ } @@ -243,7 +243,7 @@ module.exports = RemoteAuth;
diff --git a/docs/global.html b/docs/global.html index 109b57a..ef80193 100644 --- a/docs/global.html +++ b/docs/global.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Globals + whatsapp-web.js 1.23.0 » Globals @@ -15,7 +15,7 @@ @@ -68,38 +68,80 @@
+
AddParticipantsResult
+
+
+
AddParticipnatsOptions
+
+
ButtonSpec
ContactId
+
CreateGroupOptions
+
+
+
CreateGroupResult
+
+
FormattedButtonSpec
+
GroupMembershipRequest
+
+
+
GroupMembershipRequest
+
+
GroupParticipant
+
LocationSendOptions
+
+
+
MembershipRequestActionOptions
+
+
+
MembershipRequestActionOptions
+
+
+
MembershipRequestActionResult
+
+
+
MembershipRequestActionResult
+
+
MessageInfo
-
MessageSendOptions
-
-
+
MessageSendOptions
+
+
+
ParticipantResult
+
+
+
PollSendOptions
+
+
ReactionList
StickerMetadata
+
TargetOptions
+
+
@@ -418,6 +460,19 @@ + + +

GROUP_MEMBERSHIP_REQUEST

+ + +

 

+ + +

 

+ + + +

GROUP_UPDATE

@@ -1235,6 +1290,19 @@ + + +

POLL_CREATION

+ + +

 

+ + +

 

+ + + + @@ -1480,6 +1548,133 @@

Abstract types

+

AddParticipantsResult +  Object

+

An object that handles the result for addParticipants method

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

code

+ 		+

number

+ 		+

 

+ 		+

The code of the result

+
+

message

+ 		+

string

+ 		+

 

+ 		+

The result message

+
+

isInviteV4Sent

+ 		+

boolean

+ 		+

 

+ 		+

Indicates if the inviteV4 was sent to the partitipant

+
+
+
+
+

AddParticipnatsOptions +  Object

+

An object that handles options for adding participants

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

sleep

+ 		+

(Array of number or number)

+ 		+

Yes

+ 		+

The number of milliseconds to wait before adding the next participant. If it is an array, a random sleep time between the sleep[0] and sleep[1] values will be added (the difference must be >=100 ms, otherwise, a random sleep time between sleep[1] and sleep[1] + 100 will be added). If sleep is a number, a sleep time equal to its value will be added. By default, sleep is an array with a value of [250, 500]

+

Defaults to [250, 500].

+
+

autoSendInviteV4

+ 		+

boolean

+ 		+

Yes

+ 		+

If true, the inviteV4 will be sent to those participants who have restricted others from being automatically added to groups, otherwise the inviteV4 won't be sent (true by default)

+

Defaults to true.

+
+

comment

+ 		+

string

+ 		+

Yes

+ 		+

The comment to be added to an inviteV4 (empty string by default)

+

Defaults to ''.

+
+
+
+

ButtonSpec  Object

Button spec used in Buttons constructor

@@ -1587,6 +1782,199 @@
+

CreateGroupOptions +  Object

+

An object that handles options for group creation

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

messageTimer

+ 		+

number

+ 		+

Yes

+ 		+

The number of seconds for the messages to disappear in the group (0 by default, won't take an effect if the group is been creating with myself only)

+

Defaults to 0.

+
+

parentGroupId

+ 		+

(string or undefined)

+ 		+

 

+ 		+

The ID of a parent community group to link the newly created group with (won't take an effect if the group is been creating with myself only)

+
+

autoSendInviteV4

+ 		+

boolean

+ 		+

Yes

+ 		+

If true, the inviteV4 will be sent to those participants who have restricted others from being automatically added to groups, otherwise the inviteV4 won't be sent (true by default)

+

Defaults to true.

+
+

comment

+ 		+

string

+ 		+

Yes

+ 		+

The comment to be added to an inviteV4 (empty string by default)

+

Defaults to ''.

+
+
+
+
+

CreateGroupResult +  Object

+

An object that handles the result for createGroup method

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

title

+ 		+

string

+ 		+

 

+ 		+

A group title

+
+

gid

+ 		+

Object

+ 		+

 

+ 		+

An object that handles the newly created group ID

+

Values in gid have the following properties:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

server

+ 		+

string

+ 		+

 

+ 		+
+

user

+ 		+

string

+ 		+

 

+ 		+
+

_serialized

+ 		+

string

+ 		+

 

+ 		+
+
+

participants

+ 		+

Object with ParticipantResult properties

+ 		+

 

+ 		+

An object that handles the result value for each added to the group participant

+
+
+
+

FormattedButtonSpec  Object

@@ -1645,6 +2033,186 @@
+

GroupMembershipRequest +  Object

+

An object that handles the information about the group membership request

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

id

+ 		+

Object

+ 		+

 

+ 		+

The wid of a user who requests to enter the group

+
+

addedBy

+ 		+

Object

+ 		+

 

+ 		+

The wid of a user who created that request

+
+

parentGroupId

+ 		+

(Object or null)

+ 		+

 

+ 		+

The wid of a community parent group to which the current group is linked

+
+

requestMethod

+ 		+

string

+ 		+

 

+ 		+

The method used to create the request: NonAdminAdd/InviteLink/LinkedGroupJoin

+
+

t

+ 		+

number

+ 		+

 

+ 		+

The timestamp the request was created at

+
+
+
+
+

GroupMembershipRequest +  Object

+

An object that handles the information about the group membership request

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

id

+ 		+

Object

+ 		+

 

+ 		+

The wid of a user who requests to enter the group

+
+

addedBy

+ 		+

Object

+ 		+

 

+ 		+

The wid of a user who created that request

+
+

parentGroupId

+ 		+

(Object or null)

+ 		+

 

+ 		+

The wid of a community parent group to which the current group is linked

+
+

requestMethod

+ 		+

string

+ 		+

 

+ 		+

The method used to create the request: NonAdminAdd/InviteLink/LinkedGroupJoin

+
+

t

+ 		+

number

+ 		+

 

+ 		+

The timestamp the request was created at

+
+
+
+

GroupParticipant  Object

Group participant information

@@ -1704,6 +2272,288 @@
+

LocationSendOptions +  Object

+

Location send options

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

name

+ 		+

string

+ 		+

Yes

+ 		+

Location name

+
+

address

+ 		+

string

+ 		+

Yes

+ 		+

Location address

+
+

url

+ 		+

string

+ 		+

Yes

+ 		+

URL address to be shown within a location message

+
+
+
+
+

MembershipRequestActionOptions +  Object

+

An object that handles options for approveGroupMembershipRequests and rejectGroupMembershipRequests methods

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

requesterIds

+ 		+

(Array of string, string, or null)

+ 		+

 

+ 		+

User ID/s who requested to join the group, if no value is provided, the method will search for all membership requests for that group

+
+

sleep

+ 		+

(Array of number, number, or null)

+ 		+

 

+ 		+

The number of milliseconds to wait before performing an operation for the next requester. If it is an array, a random sleep time between the sleep[0] and sleep[1] values will be added (the difference must be >=100 ms, otherwise, a random sleep time between sleep[1] and sleep[1] + 100 will be added). If sleep is a number, a sleep time equal to its value will be added. By default, sleep is an array with a value of [250, 500]

+
+
+
+
+

MembershipRequestActionOptions +  Object

+

An object that handles options for approveGroupMembershipRequests and rejectGroupMembershipRequests methods

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

requesterIds

+ 		+

(Array of string, string, or null)

+ 		+

 

+ 		+

User ID/s who requested to join the group, if no value is provided, the method will search for all membership requests for that group

+
+

sleep

+ 		+

(Array of number, number, or null)

+ 		+

 

+ 		+

The number of milliseconds to wait before performing an operation for the next requester. If it is an array, a random sleep time between the sleep[0] and sleep[1] values will be added (the difference must be >=100 ms, otherwise, a random sleep time between sleep[1] and sleep[1] + 100 will be added). If sleep is a number, a sleep time equal to its value will be added. By default, sleep is an array with a value of [250, 500]

+
+
+
+
+

MembershipRequestActionResult +  Object

+

An object that handles the result for membership request action

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

requesterId

+ 		+

string

+ 		+

 

+ 		+

User ID whos membership request was approved/rejected

+
+

error

+ 		+

(number or undefined)

+ 		+

 

+ 		+

An error code that occurred during the operation for the participant

+
+

message

+ 		+

string

+ 		+

 

+ 		+

A message with a result of membership request action

+
+
+
+
+

MembershipRequestActionResult +  Object

+

An object that handles the result for membership request action

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

requesterId

+ 		+

string

+ 		+

 

+ 		+

User ID whos membership request was approved/rejected

+
+

error

+ 		+

number

+ 		+

 

+ 		+

An error code that occurred during the operation for the participant

+
+

message

+ 		+

string

+ 		+

 

+ 		+

A message with a result of membership request action

+
+
+
+

MessageInfo  Object

Message Info

@@ -1849,7 +2699,7 @@

Yes

-

Send audio as voice message

+

Send audio as voice message with a generated waveform

Defaults to false.

@@ -2046,6 +2896,132 @@
+

ParticipantResult +  Object

+

An object that represents the result for a participant added to a group

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

statusCode

+ 		+

number

+ 		+

 

+ 		+

The status code of the result

+
+

message

+ 		+

string

+ 		+

 

+ 		+

The result message

+
+

isGroupCreator

+ 		+

boolean

+ 		+

 

+ 		+

Indicates if the participant is a group creator

+
+

isInviteV4Sent

+ 		+

boolean

+ 		+

 

+ 		+

Indicates if the inviteV4 was sent to the participant

+
+
+
+
+

PollSendOptions +  Object

+

Poll send options

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

allowMultipleAnswers

+ 		+

boolean

+ 		+

Yes

+ 		+

If false it is a single choice poll, otherwise it is a multiple choice poll (false by default)

+

Defaults to false.

+
+

messageSecret

+ 		+

Array of number

+ 		+

 

+ 		+

The custom message secret, can be used as a poll ID. NOTE: it has to be a unique vector with a length of 32

+

Value can be null.

+
+
+
+

ReactionList  Object

Reaction List

@@ -2181,6 +3157,68 @@
+

TargetOptions +  Object

+

Target options object description

+
+

Properties

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeOptionalDescription
+

moduleId

+ 		+

(string or number)

+ 		+

 

+ 		+

The name or a key of the target module to search

+
+

index

+ 		+

number

+ 		+

 

+ 		+

The index value of the target module

+
+

property

+ 		+

string

+ 		+

 

+ 		+

The function name to get from a module

+
+
+
+
@@ -2191,7 +3229,7 @@
diff --git a/docs/index.html b/docs/index.html index cf698e2..9d1a398 100644 --- a/docs/index.html +++ b/docs/index.html @@ -3,7 +3,7 @@ - whatsapp-web.js 1.22.1 » Home + whatsapp-web.js 1.23.0 » Home @@ -13,7 +13,7 @@ @@ -26,7 +26,7 @@

- whatsapp-web.js 1.22.1 + whatsapp-web.js 1.23.0

@@ -767,13 +767,18 @@ limitations under the License.

+
+ Client#approveGroupMembershipRequests(groupId, options) +
+
+
Client#archiveChat()
- Client#createGroup(name, participants) + Client#createGroup(title, participants, options)
@@ -842,6 +847,11 @@ limitations under the License.

+
+ Client#event:group_membership_request +
+
+
Client#event:group_update
@@ -857,16 +867,16 @@ limitations under the License.

-
- Client#event:message -
-
-
+
+ Client#event:message +
+
+
Client#event:message_ack
@@ -957,6 +967,11 @@ limitations under the License.

+
+ Client#getGroupMembershipRequests(groupId) +
+
+
Client#getInviteInfo(inviteCode)
@@ -977,16 +992,16 @@ limitations under the License.

-
- Client#getProfilePicUrl(contactId) -
-
-
+
+ Client#getProfilePicUrl(contactId) +
+
+
Client#getState()
@@ -1032,6 +1047,11 @@ limitations under the License.

+
+ Client#rejectGroupMembershipRequests(groupId, options) +
+
+
Client#resetState()
@@ -1348,6 +1368,11 @@ limitations under the License.

+
+ Events.GROUP_MEMBERSHIP_REQUEST +
+
+
Events.GROUP_UPDATE
@@ -1383,16 +1408,16 @@ limitations under the License.

-
- Events.MESSAGE_REACTION -
-
-
+
+ Events.MESSAGE_REACTION +
+
+
Events.MESSAGE_RECEIVED
@@ -1451,7 +1476,12 @@ limitations under the License.

- GroupChat#addParticipants(participantIds) + GroupChat#addParticipants(participantIds, options) +
+
+
+
+ GroupChat#approveGroupMembershipRequests(options)
@@ -1516,12 +1546,12 @@ limitations under the License.

- GroupChat#getInviteCode() + GroupChat#getGroupMembershipRequests()
- GroupChat#getLabels() + GroupChat#getInviteCode()
@@ -1530,6 +1560,11 @@ limitations under the License.

+
+ GroupChat#getLabels() +
+
+
GroupChat#id
@@ -1606,7 +1641,7 @@ limitations under the License.

- GroupChat#removeParticipants(participantIds) + GroupChat#rejectGroupMembershipRequests(options)
@@ -1615,6 +1650,11 @@ limitations under the License.

+
+ GroupChat#removeParticipants(participantIds) +
+
+
GroupChat#revokeInvite()
@@ -2114,7 +2154,12 @@ limitations under the License.

- Location(latitude, longitude, description) + Location(latitude, longitude[, options]) +
+
+
+
+ Location#address
@@ -2138,11 +2183,21 @@ limitations under the License.

+
+ Location#name +
+
+
+
+ Location#url +
+
+
@@ -2666,6 +2721,11 @@ limitations under the License.

+
+ MessageTypes.POLL_CREATION +
+
+
MessageTypes.PRODUCT
@@ -2858,6 +2918,48 @@ limitations under the License.

+
+
+

Poll

+
+
+
+
+ Poll(pollName, pollOptions, options) +
+
+
+
+ Poll#options +
+
+
+
+
+ +
+
+
+ Poll#pollName +
+
+
+
+ Poll#pollOptions +
+
+
+
+
+ +
+
+
+
+ +
+
+

PrivateChat

@@ -3601,11 +3703,21 @@ limitations under the License.

+
+ window.injectToFunction(target, callback) +
+
+
+
+ window.WWebJS.generateWaveform() +
+
+
@@ -3622,7 +3734,7 @@ limitations under the License.

diff --git a/docs/scripts/jsdoc-toc.js b/docs/scripts/jsdoc-toc.js index e363469..80c357f 100644 --- a/docs/scripts/jsdoc-toc.js +++ b/docs/scripts/jsdoc-toc.js @@ -6,7 +6,7 @@ treeNode.tree({ autoEscape: false, closedIcon: '⇢', - data: [{"label":"Globals","id":"global","children":[]},{"label":"Base","id":"Base","children":[]},{"label":"BaseAuthStrategy","id":"BaseAuthStrategy","children":[]},{"label":"BusinessContact","id":"BusinessContact","children":[]},{"label":"Buttons","id":"Buttons","children":[]},{"label":"Call","id":"Call","children":[]},{"label":"Chat","id":"Chat","children":[]},{"label":"Client","id":"Client","children":[]},{"label":"ClientInfo","id":"ClientInfo","children":[]},{"label":"Contact","id":"Contact","children":[]},{"label":"GroupChat","id":"GroupChat","children":[]},{"label":"GroupNotification","id":"GroupNotification","children":[]},{"label":"InterfaceController","id":"InterfaceController","children":[]},{"label":"Label","id":"Label","children":[]},{"label":"LegacySessionAuth","id":"LegacySessionAuth","children":[]},{"label":"List","id":"List","children":[]},{"label":"LocalAuth","id":"LocalAuth","children":[]},{"label":"LocalWebCache","id":"LocalWebCache","children":[]},{"label":"Location","id":"Location","children":[]},{"label":"Message","id":"Message","children":[]},{"label":"MessageMedia","id":"MessageMedia","children":[]},{"label":"NoAuth","id":"NoAuth","children":[]},{"label":"Order","id":"Order","children":[]},{"label":"PrivateChat","id":"PrivateChat","children":[]},{"label":"PrivateContact","id":"PrivateContact","children":[]},{"label":"Product","id":"Product","children":[]},{"label":"Reaction","id":"Reaction","children":[]},{"label":"RemoteAuth","id":"RemoteAuth","children":[]},{"label":"RemoteWebCache","id":"RemoteWebCache","children":[]},{"label":"Util","id":"Util","children":[]},{"label":"WebCache","id":"WebCache","children":[]}], + data: [{"label":"Globals","id":"global","children":[]},{"label":"Base","id":"Base","children":[]},{"label":"BaseAuthStrategy","id":"BaseAuthStrategy","children":[]},{"label":"BusinessContact","id":"BusinessContact","children":[]},{"label":"Buttons","id":"Buttons","children":[]},{"label":"Call","id":"Call","children":[]},{"label":"Chat","id":"Chat","children":[]},{"label":"Client","id":"Client","children":[]},{"label":"ClientInfo","id":"ClientInfo","children":[]},{"label":"Contact","id":"Contact","children":[]},{"label":"GroupChat","id":"GroupChat","children":[]},{"label":"GroupNotification","id":"GroupNotification","children":[]},{"label":"InterfaceController","id":"InterfaceController","children":[]},{"label":"Label","id":"Label","children":[]},{"label":"LegacySessionAuth","id":"LegacySessionAuth","children":[]},{"label":"List","id":"List","children":[]},{"label":"LocalAuth","id":"LocalAuth","children":[]},{"label":"LocalWebCache","id":"LocalWebCache","children":[]},{"label":"Location","id":"Location","children":[]},{"label":"Message","id":"Message","children":[]},{"label":"MessageMedia","id":"MessageMedia","children":[]},{"label":"NoAuth","id":"NoAuth","children":[]},{"label":"Order","id":"Order","children":[]},{"label":"Poll","id":"Poll","children":[]},{"label":"PrivateChat","id":"PrivateChat","children":[]},{"label":"PrivateContact","id":"PrivateContact","children":[]},{"label":"Product","id":"Product","children":[]},{"label":"Reaction","id":"Reaction","children":[]},{"label":"RemoteAuth","id":"RemoteAuth","children":[]},{"label":"RemoteWebCache","id":"RemoteWebCache","children":[]},{"label":"Util","id":"Util","children":[]},{"label":"WebCache","id":"WebCache","children":[]}], openedIcon: ' ⇣', saveState: false, useContextMenu: false diff --git a/docs/structures_Base.js.html b/docs/structures_Base.js.html index 351b63f..dc4ee1f 100644 --- a/docs/structures_Base.js.html +++ b/docs/structures_Base.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/Base.js + whatsapp-web.js 1.23.0 » Source: structures/Base.js @@ -15,7 +15,7 @@ @@ -60,7 +60,7 @@ module.exports = Base;
diff --git a/docs/structures_BusinessContact.js.html b/docs/structures_BusinessContact.js.html index 7c14840..54b5345 100644 --- a/docs/structures_BusinessContact.js.html +++ b/docs/structures_BusinessContact.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/BusinessContact.js + whatsapp-web.js 1.23.0 » Source: structures/BusinessContact.js @@ -15,7 +15,7 @@ @@ -59,7 +59,7 @@ module.exports = BusinessContact;
diff --git a/docs/structures_Buttons.js.html b/docs/structures_Buttons.js.html index 94fcc32..0ccc184 100644 --- a/docs/structures_Buttons.js.html +++ b/docs/structures_Buttons.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/Buttons.js + whatsapp-web.js 1.23.0 » Source: structures/Buttons.js @@ -15,7 +15,7 @@ @@ -120,7 +120,7 @@ module.exports = Buttons;
diff --git a/docs/structures_Call.js.html b/docs/structures_Call.js.html index 1615449..089363c 100644 --- a/docs/structures_Call.js.html +++ b/docs/structures_Call.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/Call.js + whatsapp-web.js 1.23.0 » Source: structures/Call.js @@ -15,7 +15,7 @@ @@ -114,7 +114,7 @@ module.exports = Call;
diff --git a/docs/structures_Chat.js.html b/docs/structures_Chat.js.html index 58e9d99..c9dec6e 100644 --- a/docs/structures_Chat.js.html +++ b/docs/structures_Chat.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/Chat.js + whatsapp-web.js 1.23.0 » Source: structures/Chat.js @@ -15,7 +15,7 @@ @@ -314,7 +314,7 @@ module.exports = Chat;
diff --git a/docs/structures_ClientInfo.js.html b/docs/structures_ClientInfo.js.html index a710b51..4c19f3c 100644 --- a/docs/structures_ClientInfo.js.html +++ b/docs/structures_ClientInfo.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/ClientInfo.js + whatsapp-web.js 1.23.0 » Source: structures/ClientInfo.js @@ -15,7 +15,7 @@ @@ -109,7 +109,7 @@ module.exports = ClientInfo;
diff --git a/docs/structures_Contact.js.html b/docs/structures_Contact.js.html index 3ae7bc4..06a1e0a 100644 --- a/docs/structures_Contact.js.html +++ b/docs/structures_Contact.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/Contact.js + whatsapp-web.js 1.23.0 » Source: structures/Contact.js @@ -15,7 +15,7 @@ @@ -247,7 +247,7 @@ module.exports = Contact;
diff --git a/docs/structures_GroupChat.js.html b/docs/structures_GroupChat.js.html index 4d597fb..319c776 100644 --- a/docs/structures_GroupChat.js.html +++ b/docs/structures_GroupChat.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/GroupChat.js + whatsapp-web.js 1.23.0 » Source: structures/GroupChat.js @@ -15,7 +15,7 @@ @@ -85,27 +85,140 @@ class GroupChat extends Chat { } /** - * Adds a list of participants by ID to the group - * @param {Array<string>} participantIds - * @returns {Promise<Object>} + * An object that handles the result for {@link addParticipants} method + * @typedef {Object} AddParticipantsResult + * @property {number} code The code of the result + * @property {string} message The result message + * @property {boolean} isInviteV4Sent Indicates if the inviteV4 was sent to the partitipant */ - async addParticipants(participantIds) { - return await this.client.pupPage.evaluate(async (chatId, participantIds) => { - const chatWid = window.Store.WidFactory.createWid(chatId); - const chat = await window.Store.Chat.find(chatWid); - const participants = await Promise.all(participantIds.map(async p => { - const wid = window.Store.WidFactory.createWid(p); - return await window.Store.Contact.get(wid); - })); - await window.Store.GroupParticipants.addParticipants(chat, participants); - return { status: 200 }; - }, this.id._serialized, participantIds); + + /** + * An object that handles options for adding participants + * @typedef {Object} AddParticipnatsOptions + * @property {Array<number>|number} [sleep = [250, 500]] The number of milliseconds to wait before adding the next participant. If it is an array, a random sleep time between the sleep[0] and sleep[1] values will be added (the difference must be >=100 ms, otherwise, a random sleep time between sleep[1] and sleep[1] + 100 will be added). If sleep is a number, a sleep time equal to its value will be added. By default, sleep is an array with a value of [250, 500] + * @property {boolean} [autoSendInviteV4 = true] If true, the inviteV4 will be sent to those participants who have restricted others from being automatically added to groups, otherwise the inviteV4 won't be sent (true by default) + * @property {string} [comment = ''] The comment to be added to an inviteV4 (empty string by default) + */ + + /** + * Adds a list of participants by ID to the group + * @param {string|Array<string>} participantIds + * @param {AddParticipnatsOptions} options An object thay handles options for adding participants + * @returns {Promise<Object.<string, AddParticipantsResult>|string>} Returns an object with the resulting data or an error message as a string + */ + async addParticipants(participantIds, options = {}) { + return await this.client.pupPage.evaluate(async (groupId, participantIds, options) => { + const { sleep = [250, 500], autoSendInviteV4 = true, comment = '' } = options; + const participantData = {}; + + !Array.isArray(participantIds) && (participantIds = [participantIds]); + const groupWid = window.Store.WidFactory.createWid(groupId); + const group = await window.Store.Chat.find(groupWid); + const participantWids = participantIds.map((p) => window.Store.WidFactory.createWid(p)); + + const errorCodes = { + default: 'An unknown error occupied while adding a participant', + isGroupEmpty: 'AddParticipantsError: The participant can\'t be added to an empty group', + iAmNotAdmin: 'AddParticipantsError: You have no admin rights to add a participant to a group', + 200: 'The participant was added successfully', + 403: 'The participant can be added by sending private invitation only', + 404: 'The phone number is not registered on WhatsApp', + 408: 'You cannot add this participant because they recently left the group', + 409: 'The participant is already a group member', + 417: 'The participant can\'t be added to the community. You can invite them privately to join this group through its invite link', + 419: 'The participant can\'t be added because the group is full' + }; + + await window.Store.GroupMetadata.queryAndUpdate(groupWid); + const groupMetadata = group.groupMetadata; + const groupParticipants = groupMetadata?.participants; + + if (!groupParticipants) { + return errorCodes.isGroupEmpty; + } + + if (!group.iAmAdmin()) { + return errorCodes.iAmNotAdmin; + } + + const _getSleepTime = (sleep) => { + if (!Array.isArray(sleep) || sleep.length === 2 && sleep[0] === sleep[1]) { + return sleep; + } + if (sleep.length === 1) { + return sleep[0]; + } + (sleep[1] - sleep[0]) < 100 && (sleep[0] = sleep[1]) && (sleep[1] += 100); + return Math.floor(Math.random() * (sleep[1] - sleep[0] + 1)) + sleep[0]; + }; + + for (const pWid of participantWids) { + const pId = pWid._serialized; + + participantData[pId] = { + code: undefined, + message: undefined, + isInviteV4Sent: false + }; + + if (groupParticipants.some(p => p.id._serialized === pId)) { + participantData[pId].code = 409; + participantData[pId].message = errorCodes[409]; + continue; + } + + if (!(await window.Store.QueryExist(pWid))?.wid) { + participantData[pId].code = 404; + participantData[pId].message = errorCodes[404]; + continue; + } + + const rpcResult = + await window.WWebJS.getAddParticipantsRpcResult(groupMetadata, groupWid, pWid); + const { code: rpcResultCode } = rpcResult; + + participantData[pId].code = rpcResultCode; + participantData[pId].message = + errorCodes[rpcResultCode] || errorCodes.default; + + if (autoSendInviteV4 && rpcResultCode === 403) { + let userChat, isInviteV4Sent = false; + window.Store.ContactCollection.gadd(pWid, { silent: true }); + + if (rpcResult.name === 'ParticipantRequestCodeCanBeSent' && + (userChat = await window.Store.Chat.find(pWid))) { + const groupName = group.formattedTitle || group.name; + const res = await window.Store.GroupInviteV4.sendGroupInviteMessage( + userChat, + group.id._serialized, + groupName, + rpcResult.inviteV4Code, + rpcResult.inviteV4CodeExp, + comment, + await window.WWebJS.getProfilePicThumbToBase64(groupWid) + ); + isInviteV4Sent = window.compareWwebVersions(window.Debug.VERSION, '<', '2.2335.6') + ? res === 'OK' + : res.messageSendResult === 'OK'; + } + + participantData[pId].isInviteV4Sent = isInviteV4Sent; + } + + sleep && + participantWids.length > 1 && + participantWids.indexOf(pWid) !== participantWids.length - 1 && + (await new Promise((resolve) => setTimeout(resolve, _getSleepTime(sleep)))); + } + + return participantData; + }, this.id._serialized, participantIds, options); } /** * Removes a list of participants by ID to the group * @param {Array<string>} participantIds - * @returns {Promise<Object>} + * @returns {Promise<{ status: number }>} */ async removeParticipants(participantIds) { return await this.client.pupPage.evaluate(async (chatId, participantIds) => { @@ -277,7 +390,7 @@ class GroupChat extends Chat { async getInviteCode() { const codeRes = await this.client.pupPage.evaluate(async chatId => { const chatWid = window.Store.WidFactory.createWid(chatId); - return window.Store.Invite.queryGroupInviteCode(chatWid); + return window.Store.GroupInvite.queryGroupInviteCode(chatWid); }, this.id._serialized); return codeRes.code; @@ -290,11 +403,62 @@ class GroupChat extends Chat { async revokeInvite() { const codeRes = await this.client.pupPage.evaluate(chatId => { const chatWid = window.Store.WidFactory.createWid(chatId); - return window.Store.Invite.resetGroupInviteCode(chatWid); + return window.Store.GroupInvite.resetGroupInviteCode(chatWid); }, this.id._serialized); return codeRes.code; } + + /** + * An object that handles the information about the group membership request + * @typedef {Object} GroupMembershipRequest + * @property {Object} id The wid of a user who requests to enter the group + * @property {Object} addedBy The wid of a user who created that request + * @property {Object|null} parentGroupId The wid of a community parent group to which the current group is linked + * @property {string} requestMethod The method used to create the request: NonAdminAdd/InviteLink/LinkedGroupJoin + * @property {number} t The timestamp the request was created at + */ + + /** + * Gets an array of membership requests + * @returns {Promise<Array<GroupMembershipRequest>>} An array of membership requests + */ + async getGroupMembershipRequests() { + return await this.client.getGroupMembershipRequests(this.id._serialized); + } + + /** + * An object that handles the result for membership request action + * @typedef {Object} MembershipRequestActionResult + * @property {string} requesterId User ID whos membership request was approved/rejected + * @property {number} error An error code that occurred during the operation for the participant + * @property {string} message A message with a result of membership request action + */ + + /** + * An object that handles options for {@link approveGroupMembershipRequests} and {@link rejectGroupMembershipRequests} methods + * @typedef {Object} MembershipRequestActionOptions + * @property {Array<string>|string|null} requesterIds User ID/s who requested to join the group, if no value is provided, the method will search for all membership requests for that group + * @property {Array<number>|number|null} sleep The number of milliseconds to wait before performing an operation for the next requester. If it is an array, a random sleep time between the sleep[0] and sleep[1] values will be added (the difference must be >=100 ms, otherwise, a random sleep time between sleep[1] and sleep[1] + 100 will be added). If sleep is a number, a sleep time equal to its value will be added. By default, sleep is an array with a value of [250, 500] + */ + + /** + * Approves membership requests if any + * @param {MembershipRequestActionOptions} options Options for performing a membership request action + * @returns {Promise<Array<MembershipRequestActionResult>>} Returns an array of requester IDs whose membership requests were approved and an error for each requester, if any occurred during the operation. If there are no requests, an empty array will be returned + */ + async approveGroupMembershipRequests(options = {}) { + return await this.client.approveGroupMembershipRequests(this.id._serialized, options); + } + + /** + * Rejects membership requests if any + * @param {MembershipRequestActionOptions} options Options for performing a membership request action + * @returns {Promise<Array<MembershipRequestActionResult>>} Returns an array of requester IDs whose membership requests were rejected and an error for each requester, if any occurred during the operation. If there are no requests, an empty array will be returned + */ + async rejectGroupMembershipRequests(options = {}) { + return await this.client.rejectGroupMembershipRequests(this.id._serialized, options); + } /** * Makes the bot leave the group @@ -321,7 +485,7 @@ module.exports = GroupChat;
diff --git a/docs/structures_GroupNotification.js.html b/docs/structures_GroupNotification.js.html index 3cec366..9e71139 100644 --- a/docs/structures_GroupNotification.js.html +++ b/docs/structures_GroupNotification.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/GroupNotification.js + whatsapp-web.js 1.23.0 » Source: structures/GroupNotification.js @@ -15,7 +15,7 @@ @@ -143,7 +143,7 @@ module.exports = GroupNotification;
diff --git a/docs/structures_Label.js.html b/docs/structures_Label.js.html index b78fe3c..a0df02a 100644 --- a/docs/structures_Label.js.html +++ b/docs/structures_Label.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/Label.js + whatsapp-web.js 1.23.0 » Source: structures/Label.js @@ -15,7 +15,7 @@ @@ -88,7 +88,7 @@ module.exports = Label;
diff --git a/docs/structures_List.js.html b/docs/structures_List.js.html index 5a92290..a6e5e51 100644 --- a/docs/structures_List.js.html +++ b/docs/structures_List.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/List.js + whatsapp-web.js 1.23.0 » Source: structures/List.js @@ -15,7 +15,7 @@ @@ -118,7 +118,7 @@ module.exports = List;
diff --git a/docs/structures_Location.js.html b/docs/structures_Location.js.html index 75b3e0f..c56cb78 100644 --- a/docs/structures_Location.js.html +++ b/docs/structures_Location.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/Location.js + whatsapp-web.js 1.23.0 » Source: structures/Location.js @@ -15,7 +15,7 @@ @@ -31,6 +31,14 @@ 
'use strict';
 
+/**
+ * Location send options
+ * @typedef {Object} LocationSendOptions
+ * @property {string} [name] Location name
+ * @property {string} [address] Location address
+ * @property {string} [url] URL address to be shown within a location message
+ */
+
 /**
  * Location information
  */
@@ -38,9 +46,9 @@ class Location {
     /**
      * @param {number} latitude
      * @param {number} longitude
-     * @param {?string} description
+     * @param {LocationSendOptions} [options] Location send options
      */
-    constructor(latitude, longitude, description) {
+    constructor(latitude, longitude, options = {}) {
         /**
          * Location latitude
          * @type {number}
@@ -55,9 +63,29 @@ class Location {
 
         /**
          * Name for the location
-         * @type {?string}
+         * @type {string|undefined}
          */
-        this.description = description;
+        this.name = options.name;
+
+        /**
+         * Location address
+         * @type {string|undefined}
+         */
+        this.address = options.address;
+
+        /**
+         * URL address to be shown within a location message
+         * @type {string|undefined}
+         */
+        this.url = options.url;
+
+        /**
+         * Location full description
+         * @type {string|undefined}
+         */
+        this.description = this.name && this.address
+            ? `${this.name}\n${this.address}`
+            : this.name || this.address || '';
     }
 }
 
@@ -71,7 +99,7 @@ module.exports = Location;
diff --git a/docs/structures_Message.js.html b/docs/structures_Message.js.html index 9a06df8..6b1b4bb 100644 --- a/docs/structures_Message.js.html +++ b/docs/structures_Message.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/Message.js + whatsapp-web.js 1.23.0 » Source: structures/Message.js @@ -15,7 +15,7 @@ @@ -82,7 +82,7 @@ class Message extends Base { * Message content * @type {string} */ - this.body = this.hasMedia ? data.caption || '' : data.body || ''; + this.body = this.hasMedia ? data.caption || '' : data.body || data.pollName || ''; /** * Message type @@ -182,7 +182,21 @@ class Message extends Base { * Location information contained in the message, if the message is type "location" * @type {Location} */ - this.location = data.type === MessageTypes.LOCATION ? new Location(data.lat, data.lng, data.loc) : undefined; + this.location = (() => { + if (data.type !== MessageTypes.LOCATION) { + return undefined; + } + let description; + if (data.loc && typeof data.loc === 'string') { + let splitted = data.loc.split('\n'); + description = { + name: splitted[0], + address: splitted[1], + url: data.clientUrl + }; + } + return new Location(data.lat, data.lng, description); + })(); /** * List of vCards contained in the message. @@ -199,8 +213,8 @@ class Message extends Base { inviteCodeExp: data.inviteCodeExp, groupId: data.inviteGrp, groupName: data.inviteGrpName, - fromId: data.from?._serialized ? data.from._serialized : data.from, - toId: data.to?._serialized ? data.to._serialized : data.to + fromId: '_serialized' in data.from ? data.from._serialized : data.from, + toId: '_serialized' in data.to ? data.to._serialized : data.to } : undefined; /** @@ -288,6 +302,20 @@ class Message extends Base { this.selectedRowId = data.listResponse.singleSelectReply.selectedRowId; } + if (this.type === MessageTypes.POLL_CREATION) { + this.pollName = data.pollName; + this.pollOptions = data.pollOptions; + this.allowMultipleAnswers = Boolean(!data.pollSelectableOptionsCount); + this.pollInvalidated = data.pollInvalidated; + this.isSentCagPollCreation = data.isSentCagPollCreation; + + delete this._data.pollName; + delete this._data.pollOptions; + delete this._data.pollSelectableOptionsCount; + delete this._data.pollInvalidated; + delete this._data.isSentCagPollCreation; + } + return super._patch(data); } @@ -667,7 +695,7 @@ module.exports = Message;
diff --git a/docs/structures_MessageMedia.js.html b/docs/structures_MessageMedia.js.html index 11d662b..60a1248 100644 --- a/docs/structures_MessageMedia.js.html +++ b/docs/structures_MessageMedia.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/MessageMedia.js + whatsapp-web.js 1.23.0 » Source: structures/MessageMedia.js @@ -15,7 +15,7 @@ @@ -150,7 +150,7 @@ module.exports = MessageMedia;
diff --git a/docs/structures_Order.js.html b/docs/structures_Order.js.html index 9a8efbb..cb091f3 100644 --- a/docs/structures_Order.js.html +++ b/docs/structures_Order.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/Order.js + whatsapp-web.js 1.23.0 » Source: structures/Order.js @@ -15,7 +15,7 @@ @@ -90,7 +90,7 @@ module.exports = Order;
diff --git a/docs/structures_Payment.js.html b/docs/structures_Payment.js.html index 0f2559e..f4598b1 100644 --- a/docs/structures_Payment.js.html +++ b/docs/structures_Payment.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/Payment.js + whatsapp-web.js 1.23.0 » Source: structures/Payment.js @@ -15,7 +15,7 @@ @@ -118,7 +118,7 @@ module.exports = Payment;
diff --git a/docs/structures_Poll.js.html b/docs/structures_Poll.js.html new file mode 100644 index 0000000..da5c481 --- /dev/null +++ b/docs/structures_Poll.js.html @@ -0,0 +1,98 @@ + + + + + + + whatsapp-web.js 1.23.0 » Source: structures/Poll.js + + + + + + + + +
+
+
+ +
+
+

Source: structures/Poll.js

+
+
+ 
'use strict';
+
+/**
+ * Poll send options
+ * @typedef {Object} PollSendOptions
+ * @property {boolean} [allowMultipleAnswers=false] If false it is a single choice poll, otherwise it is a multiple choice poll (false by default)
+ * @property {?Array<number>} messageSecret The custom message secret, can be used as a poll ID. NOTE: it has to be a unique vector with a length of 32
+ */
+
+/** Represents a Poll on WhatsApp */
+class Poll {
+    /**
+     * @param {string} pollName
+     * @param {Array<string>} pollOptions
+     * @param {PollSendOptions} options
+     */
+    constructor(pollName, pollOptions, options = {}) {
+        /**
+         * The name of the poll
+         * @type {string}
+         */
+        this.pollName = pollName.trim();
+
+        /**
+         * The array of poll options
+         * @type {Array.<{name: string, localId: number}>}
+         */
+        this.pollOptions = pollOptions.map((option, index) => ({
+            name: option.trim(),
+            localId: index
+        }));
+
+        /**
+         * The send options for the poll
+         * @type {PollSendOptions}
+         */
+        this.options = {
+            allowMultipleAnswers: options.allowMultipleAnswers === true,
+            messageSecret: options.messageSecret
+        };
+    }
+}
+
+module.exports = Poll;
+
+
+
+
+ +
+
+
+ +
+ + + + + + + + + \ No newline at end of file diff --git a/docs/structures_PrivateChat.js.html b/docs/structures_PrivateChat.js.html index 9656e1a..e337bd5 100644 --- a/docs/structures_PrivateChat.js.html +++ b/docs/structures_PrivateChat.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/PrivateChat.js + whatsapp-web.js 1.23.0 » Source: structures/PrivateChat.js @@ -15,7 +15,7 @@ @@ -51,7 +51,7 @@ module.exports = PrivateChat;
diff --git a/docs/structures_PrivateContact.js.html b/docs/structures_PrivateContact.js.html index a1f267e..5017b0f 100644 --- a/docs/structures_PrivateContact.js.html +++ b/docs/structures_PrivateContact.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/PrivateContact.js + whatsapp-web.js 1.23.0 » Source: structures/PrivateContact.js @@ -15,7 +15,7 @@ @@ -51,7 +51,7 @@ module.exports = PrivateContact;
diff --git a/docs/structures_Product.js.html b/docs/structures_Product.js.html index 54d5ba5..a5e898f 100644 --- a/docs/structures_Product.js.html +++ b/docs/structures_Product.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/Product.js + whatsapp-web.js 1.23.0 » Source: structures/Product.js @@ -15,7 +15,7 @@ @@ -106,7 +106,7 @@ module.exports = Product;
diff --git a/docs/structures_ProductMetadata.js.html b/docs/structures_ProductMetadata.js.html index 698f37b..c0c38ad 100644 --- a/docs/structures_ProductMetadata.js.html +++ b/docs/structures_ProductMetadata.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/ProductMetadata.js + whatsapp-web.js 1.23.0 » Source: structures/ProductMetadata.js @@ -15,7 +15,7 @@ @@ -63,7 +63,7 @@ module.exports = ProductMetadata;
diff --git a/docs/structures_Reaction.js.html b/docs/structures_Reaction.js.html index 2bc153c..a2ac667 100644 --- a/docs/structures_Reaction.js.html +++ b/docs/structures_Reaction.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: structures/Reaction.js + whatsapp-web.js 1.23.0 » Source: structures/Reaction.js @@ -15,7 +15,7 @@ @@ -107,7 +107,7 @@ module.exports = Reaction;
diff --git a/docs/util_Constants.js.html b/docs/util_Constants.js.html index 57ab240..fb51599 100644 --- a/docs/util_Constants.js.html +++ b/docs/util_Constants.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: util/Constants.js + whatsapp-web.js 1.23.0 » Source: util/Constants.js @@ -15,7 +15,7 @@ @@ -87,6 +87,7 @@ exports.Events = { GROUP_JOIN: 'group_join', GROUP_LEAVE: 'group_leave', GROUP_ADMIN_CHANGED: 'group_admin_changed', + GROUP_MEMBERSHIP_REQUEST: 'group_membership_request', GROUP_UPDATE: 'group_update', QR_RECEIVED: 'qr', LOADING_SCREEN: 'loading_screen', @@ -138,6 +139,7 @@ exports.MessageTypes = { PROTOCOL: 'protocol', REACTION: 'reaction', TEMPLATE_BUTTON_REPLY: 'template_button_reply', + POLL_CREATION: 'poll_creation', }; /** @@ -211,7 +213,7 @@ exports.MessageAck = {
diff --git a/docs/util_Injected.js.html b/docs/util_Injected.js.html new file mode 100644 index 0000000..3e1a088 --- /dev/null +++ b/docs/util_Injected.js.html @@ -0,0 +1,1148 @@ + + + + + + + whatsapp-web.js 1.23.0 » Source: util/Injected.js + + + + + + + + +
+
+
+ +
+
+

Source: util/Injected.js

+
+
+ 
'use strict';
+
+// Exposes the internal Store to the WhatsApp Web client
+exports.ExposeStore = (moduleRaidStr) => {
+    eval('var moduleRaid = ' + moduleRaidStr);
+    // eslint-disable-next-line no-undef
+    window.mR = moduleRaid();
+    window.Store = Object.assign({}, window.mR.findModule(m => m.default && m.default.Chat)[0].default);
+    window.Store.AppState = window.mR.findModule('Socket')[0].Socket;
+    window.Store.Conn = window.mR.findModule('Conn')[0].Conn;
+    window.Store.BlockContact = window.mR.findModule('blockContact')[0];
+    window.Store.Call = window.mR.findModule((module) => module.default && module.default.Call)[0].default.Call;
+    window.Store.Cmd = window.mR.findModule('Cmd')[0].Cmd;
+    window.Store.CryptoLib = window.mR.findModule('decryptE2EMedia')[0];
+    window.Store.DownloadManager = window.mR.findModule('downloadManager')[0].downloadManager;
+    window.Store.GroupMetadata = window.mR.findModule('GroupMetadata')[0].default.GroupMetadata;
+    window.Store.GroupMetadata.queryAndUpdate = window.mR.findModule('queryAndUpdateGroupMetadataById')[0].queryAndUpdateGroupMetadataById;
+    window.Store.Label = window.mR.findModule('LabelCollection')[0].LabelCollection;
+    window.Store.ContactCollection = window.mR.findModule('ContactCollection')[0].ContactCollection;
+    window.Store.MediaPrep = window.mR.findModule('prepRawMedia')[0];
+    window.Store.MediaObject = window.mR.findModule('getOrCreateMediaObject')[0];
+    window.Store.NumberInfo = window.mR.findModule('formattedPhoneNumber')[0];
+    window.Store.MediaTypes = window.mR.findModule('msgToMediaType')[0];
+    window.Store.MediaUpload = window.mR.findModule('uploadMedia')[0];
+    window.Store.MsgKey = window.mR.findModule((module) => module.default && module.default.fromString)[0].default;
+    window.Store.MessageInfo = window.mR.findModule('sendQueryMsgInfo')[0];
+    window.Store.OpaqueData = window.mR.findModule(module => module.default && module.default.createFromData)[0].default;
+    window.Store.QueryProduct = window.mR.findModule('queryProduct')[0];
+    window.Store.QueryOrder = window.mR.findModule('queryOrder')[0];
+    window.Store.SendClear = window.mR.findModule('sendClear')[0];
+    window.Store.SendDelete = window.mR.findModule('sendDelete')[0];
+    window.Store.SendMessage = window.mR.findModule('addAndSendMsgToChat')[0];
+    window.Store.EditMessage = window.mR.findModule('addAndSendMessageEdit')[0];
+    window.Store.SendSeen = window.mR.findModule('sendSeen')[0];
+    window.Store.User = window.mR.findModule('getMaybeMeUser')[0];
+    window.Store.ContactMethods = window.mR.findModule('getUserid')[0];
+    window.Store.BusinessProfileCollection = window.mR.findModule('BusinessProfileCollection')[0].BusinessProfileCollection;
+    window.Store.UploadUtils = window.mR.findModule((module) => (module.default && module.default.encryptAndUpload) ? module.default : null)[0].default;
+    window.Store.UserConstructor = window.mR.findModule((module) => (module.default && module.default.prototype && module.default.prototype.isServer && module.default.prototype.isUser) ? module.default : null)[0].default;
+    window.Store.Validators = window.mR.findModule('findLinks')[0];
+    window.Store.VCard = window.mR.findModule('vcardFromContactModel')[0];
+    window.Store.WidFactory = window.mR.findModule('createWid')[0];
+    window.Store.ProfilePic = window.mR.findModule('profilePicResync')[0];
+    window.Store.PresenceUtils = window.mR.findModule('sendPresenceAvailable')[0];
+    window.Store.ChatState = window.mR.findModule('sendChatStateComposing')[0];
+    window.Store.findCommonGroups = window.mR.findModule('findCommonGroups')[0].findCommonGroups;
+    window.Store.StatusUtils = window.mR.findModule('setMyStatus')[0];
+    window.Store.ConversationMsgs = window.mR.findModule('loadEarlierMsgs')[0];
+    window.Store.sendReactionToMsg = window.mR.findModule('sendReactionToMsg')[0].sendReactionToMsg;
+    window.Store.createOrUpdateReactionsModule = window.mR.findModule('createOrUpdateReactions')[0];
+    window.Store.EphemeralFields = window.mR.findModule('getEphemeralFields')[0];
+    window.Store.MsgActionChecks = window.mR.findModule('canSenderRevokeMsg')[0];
+    window.Store.QuotedMsg = window.mR.findModule('getQuotedMsgObj')[0];
+    window.Store.Socket = window.mR.findModule('deprecatedSendIq')[0];
+    window.Store.SocketWap = window.mR.findModule('wap')[0];
+    window.Store.SearchContext = window.mR.findModule('getSearchContext')[0].getSearchContext;
+    window.Store.DrawerManager = window.mR.findModule('DrawerManager')[0].DrawerManager;
+    window.Store.LidUtils = window.mR.findModule('getCurrentLid')[0];
+    window.Store.WidToJid = window.mR.findModule('widToUserJid')[0];
+    window.Store.JidToWid = window.mR.findModule('userJidToUserWid')[0];
+    
+    /* eslint-disable no-undef, no-cond-assign */
+    window.Store.QueryExist = ((m = window.mR.findModule('queryExists')[0]) ? m.queryExists : window.mR.findModule('queryExist')[0].queryWidExists);
+    window.Store.ReplyUtils = (m = window.mR.findModule('canReplyMsg')).length > 0 && m[0];
+    /* eslint-enable no-undef, no-cond-assign */
+
+    window.Store.StickerTools = {
+        ...window.mR.findModule('toWebpSticker')[0],
+        ...window.mR.findModule('addWebpMetadata')[0]
+    };
+    window.Store.GroupUtils = {
+        ...window.mR.findModule('createGroup')[0],
+        ...window.mR.findModule('setGroupDescription')[0],
+        ...window.mR.findModule('sendExitGroup')[0],
+        ...window.mR.findModule('sendSetPicture')[0]
+    };
+    window.Store.GroupParticipants = {
+        ...window.mR.findModule('promoteParticipants')[0],
+        ...window.mR.findModule('sendAddParticipantsRPC')[0]
+    };
+    window.Store.GroupInvite = {
+        ...window.mR.findModule('resetGroupInviteCode')[0],
+        ...window.mR.findModule('queryGroupInvite')[0]
+    };
+    window.Store.GroupInviteV4 = {
+        ...window.mR.findModule('queryGroupInviteV4')[0],
+        ...window.mR.findModule('sendGroupInviteMessage')[0]
+    };
+    window.Store.MembershipRequestUtils = {
+        ...window.mR.findModule('getMembershipApprovalRequests')[0],
+        ...window.mR.findModule('sendMembershipRequestsActionRPC')[0]
+    };
+
+    if (!window.Store.Chat._find) {
+        window.Store.Chat._find = e => {
+            const target = window.Store.Chat.get(e);
+            return target ? Promise.resolve(target) : Promise.resolve({
+                id: e
+            });
+        };
+    }
+    
+    // eslint-disable-next-line no-undef
+    if ((m = window.mR.findModule('ChatCollection')[0]) && m.ChatCollection && typeof m.ChatCollection.findImpl === 'undefined' && typeof m.ChatCollection._find !== 'undefined') m.ChatCollection.findImpl = m.ChatCollection._find;
+
+    // TODO remove these once everybody has been updated to WWebJS with legacy sessions removed
+    const _linkPreview = window.mR.findModule('queryLinkPreview');
+    if (_linkPreview && _linkPreview[0] && _linkPreview[0].default) {
+        window.Store.Wap = _linkPreview[0].default;
+    }
+
+    const _isMDBackend = window.mR.findModule('isMDBackend');
+    if(_isMDBackend && _isMDBackend[0] && _isMDBackend[0].isMDBackend) {
+        window.Store.MDBackend = _isMDBackend[0].isMDBackend();
+    } else {
+        window.Store.MDBackend = true;
+    }
+
+    const _features = window.mR.findModule('FEATURE_CHANGE_EVENT')[0];
+    if(_features) {
+        window.Store.Features = _features.LegacyPhoneFeatures;
+    }
+
+    /**
+     * Target options object description
+     * @typedef {Object} TargetOptions
+     * @property {string|number} moduleId The name or a key of the target module to search
+     * @property {number} index The index value of the target module
+     * @property {string} property The function name to get from a module
+     */
+
+    /**
+     * Function to modify functions
+     * @param {TargetOptions} target Options specifying the target function to search for modifying
+     * @param {Function} callback Modified function
+     */
+    window.injectToFunction = (target, callback) => {
+        const module = typeof target.moduleId === 'string'
+            ? window.mR.findModule(target.moduleId)
+            : window.mR.modules[target.moduleId];
+        const originalFunction = module[target.index][target.property];
+        const modifiedFunction = (...args) => callback(originalFunction, ...args);
+        module[target.index][target.property] = modifiedFunction;
+    };
+
+    window.injectToFunction({ moduleId: 'mediaTypeFromProtobuf', index: 0, property: 'mediaTypeFromProtobuf' }, (func, ...args) => { const [proto] = args; return proto.locationMessage ? null : func(...args); });
+
+    window.injectToFunction({ moduleId: 'typeAttributeFromProtobuf', index: 0, property: 'typeAttributeFromProtobuf' }, (func, ...args) => { const [proto] = args; return proto.locationMessage || proto.groupInviteMessage ? 'text' : func(...args); });
+};
+
+exports.LoadUtils = () => {
+    window.WWebJS = {};
+
+    window.WWebJS.sendSeen = async (chatId) => {
+        let chat = window.Store.Chat.get(chatId);
+        if (chat !== undefined) {
+            await window.Store.SendSeen.sendSeen(chat, false);
+            return true;
+        }
+        return false;
+
+    };
+
+    window.WWebJS.sendMessage = async (chat, content, options = {}) => {
+        let attOptions = {};
+        if (options.attachment) {
+            attOptions = options.sendMediaAsSticker
+                ? await window.WWebJS.processStickerData(options.attachment)
+                : await window.WWebJS.processMediaData(options.attachment, {
+                    forceVoice: options.sendAudioAsVoice,
+                    forceDocument: options.sendMediaAsDocument,
+                    forceGif: options.sendVideoAsGif
+                });
+            
+            if (options.caption){
+                attOptions.caption = options.caption; 
+            }
+            content = options.sendMediaAsSticker ? undefined : attOptions.preview;
+            attOptions.isViewOnce = options.isViewOnce;
+
+            delete options.attachment;
+            delete options.sendMediaAsSticker;
+        }
+        let quotedMsgOptions = {};
+        if (options.quotedMessageId) {
+            let quotedMessage = window.Store.Msg.get(options.quotedMessageId);
+
+            // TODO remove .canReply() once all clients are updated to >= v2.2241.6
+            const canReply = window.Store.ReplyUtils ? 
+                window.Store.ReplyUtils.canReplyMsg(quotedMessage.unsafe()) : 
+                quotedMessage.canReply();
+
+            if (canReply) {
+                quotedMsgOptions = quotedMessage.msgContextInfo(chat);
+            }
+            delete options.quotedMessageId;
+        }
+
+        if (options.mentionedJidList) {
+            options.mentionedJidList = options.mentionedJidList.map(cId => window.Store.Contact.get(cId).id);
+        }
+
+        let locationOptions = {};
+        if (options.location) {
+            let { latitude, longitude, description, url } = options.location;
+            url = window.Store.Validators.findLink(url)?.href;
+            url && !description && (description = url);
+            locationOptions = {
+                type: 'location',
+                loc: description,
+                lat: latitude,
+                lng: longitude,
+                clientUrl: url
+            };
+            delete options.location;
+        }
+
+        let _pollOptions = {};
+        if (options.poll) {
+            const { pollName, pollOptions } = options.poll;
+            const { allowMultipleAnswers, messageSecret } = options.poll.options;
+            _pollOptions = {
+                type: 'poll_creation',
+                pollName: pollName,
+                pollOptions: pollOptions,
+                pollSelectableOptionsCount: allowMultipleAnswers ? 0 : 1,
+                messageSecret:
+                Array.isArray(messageSecret) && messageSecret.length === 32
+                    ? new Uint8Array(messageSecret)
+                    : window.crypto.getRandomValues(new Uint8Array(32))
+            };
+            delete options.poll;
+        }
+
+        let vcardOptions = {};
+        if (options.contactCard) {
+            let contact = window.Store.Contact.get(options.contactCard);
+            vcardOptions = {
+                body: window.Store.VCard.vcardFromContactModel(contact).vcard,
+                type: 'vcard',
+                vcardFormattedName: contact.formattedName
+            };
+            delete options.contactCard;
+        } else if (options.contactCardList) {
+            let contacts = options.contactCardList.map(c => window.Store.Contact.get(c));
+            let vcards = contacts.map(c => window.Store.VCard.vcardFromContactModel(c));
+            vcardOptions = {
+                type: 'multi_vcard',
+                vcardList: vcards,
+                body: undefined
+            };
+            delete options.contactCardList;
+        } else if (options.parseVCards && typeof (content) === 'string' && content.startsWith('BEGIN:VCARD')) {
+            delete options.parseVCards;
+            try {
+                const parsed = window.Store.VCard.parseVcard(content);
+                if (parsed) {
+                    vcardOptions = {
+                        type: 'vcard',
+                        vcardFormattedName: window.Store.VCard.vcardGetNameFromParsed(parsed)
+                    };
+                }
+            } catch (_) {
+                // not a vcard
+            }
+        }
+
+        if (options.linkPreview) {
+            delete options.linkPreview;
+
+            // Not supported yet by WhatsApp Web on MD
+            if(!window.Store.MDBackend) {
+                const link = window.Store.Validators.findLink(content);
+                if (link) {
+                    const preview = await window.Store.Wap.queryLinkPreview(link.url);
+                    preview.preview = true;
+                    preview.subtype = 'url';
+                    options = { ...options, ...preview };
+                }
+            }
+        }
+        
+        let buttonOptions = {};
+        if(options.buttons){
+            let caption;
+            if (options.buttons.type === 'chat') {
+                content = options.buttons.body;
+                caption = content;
+            } else {
+                caption = options.caption ? options.caption : ' '; //Caption can't be empty
+            }
+            buttonOptions = {
+                productHeaderImageRejected: false,
+                isFromTemplate: false,
+                isDynamicReplyButtonsMsg: true,
+                title: options.buttons.title ? options.buttons.title : undefined,
+                footer: options.buttons.footer ? options.buttons.footer : undefined,
+                dynamicReplyButtons: options.buttons.buttons,
+                replyButtons: options.buttons.buttons,
+                caption: caption
+            };
+            delete options.buttons;
+        }
+
+        let listOptions = {};
+        if (options.list) {
+            if (window.Store.Conn.platform === 'smba' || window.Store.Conn.platform === 'smbi') {
+                throw '[LT01] Whatsapp business can\'t send this yet';
+            }
+            listOptions = {
+                type: 'list',
+                footer: options.list.footer,
+                list: {
+                    ...options.list,
+                    listType: 1
+                },
+                body: options.list.description
+            };
+            delete options.list;
+            delete listOptions.list.footer;
+        }
+
+        const meUser = window.Store.User.getMaybeMeUser();
+        const isMD = window.Store.MDBackend;
+        const newId = await window.Store.MsgKey.newId();
+        
+        const newMsgId = new window.Store.MsgKey({
+            from: meUser,
+            to: chat.id,
+            id: newId,
+            participant: isMD && chat.id.isGroup() ? meUser : undefined,
+            selfDir: 'out',
+        });
+
+        const extraOptions = options.extraOptions || {};
+        delete options.extraOptions;
+
+        const ephemeralFields = window.Store.EphemeralFields.getEphemeralFields(chat);
+
+        const message = {
+            ...options,
+            id: newMsgId,
+            ack: 0,
+            body: content,
+            from: meUser,
+            to: chat.id,
+            local: true,
+            self: 'out',
+            t: parseInt(new Date().getTime() / 1000),
+            isNewMsg: true,
+            type: 'chat',
+            ...ephemeralFields,
+            ...locationOptions,
+            ..._pollOptions,
+            ...attOptions,
+            ...(attOptions.toJSON ? attOptions.toJSON() : {}),
+            ...quotedMsgOptions,
+            ...vcardOptions,
+            ...buttonOptions,
+            ...listOptions,
+            ...extraOptions
+        };
+
+        await window.Store.SendMessage.addAndSendMsgToChat(chat, message);
+        return window.Store.Msg.get(newMsgId._serialized);
+    };
+	
+    window.WWebJS.editMessage = async (msg, content, options = {}) => {
+
+        const extraOptions = options.extraOptions || {};
+        delete options.extraOptions;
+        
+        if (options.mentionedJidList) {
+            options.mentionedJidList = options.mentionedJidList.map(cId => window.Store.Contact.get(cId).id);
+        }
+
+        if (options.linkPreview) {
+            options.linkPreview = null;
+
+            // Not supported yet by WhatsApp Web on MD
+            if(!window.Store.MDBackend) {
+                const link = window.Store.Validators.findLink(content);
+                if (link) {
+                    const preview = await window.Store.Wap.queryLinkPreview(link.url);
+                    preview.preview = true;
+                    preview.subtype = 'url';
+                    options = { ...options, ...preview };
+                }
+            }
+        }
+
+
+        const internalOptions = {
+            ...options,
+            ...extraOptions
+        };
+
+        await window.Store.EditMessage.sendMessageEdit(msg, content, internalOptions);
+        return window.Store.Msg.get(msg.id._serialized);
+    };
+
+    window.WWebJS.toStickerData = async (mediaInfo) => {
+        if (mediaInfo.mimetype == 'image/webp') return mediaInfo;
+
+        const file = window.WWebJS.mediaInfoToFile(mediaInfo);
+        const webpSticker = await window.Store.StickerTools.toWebpSticker(file);
+        const webpBuffer = await webpSticker.arrayBuffer();
+        const data = window.WWebJS.arrayBufferToBase64(webpBuffer);
+
+        return {
+            mimetype: 'image/webp',
+            data
+        };
+    };
+
+    window.WWebJS.processStickerData = async (mediaInfo) => {
+        if (mediaInfo.mimetype !== 'image/webp') throw new Error('Invalid media type');
+
+        const file = window.WWebJS.mediaInfoToFile(mediaInfo);
+        let filehash = await window.WWebJS.getFileHash(file);
+        let mediaKey = await window.WWebJS.generateHash(32);
+
+        const controller = new AbortController();
+        const uploadedInfo = await window.Store.UploadUtils.encryptAndUpload({
+            blob: file,
+            type: 'sticker',
+            signal: controller.signal,
+            mediaKey
+        });
+
+        const stickerInfo = {
+            ...uploadedInfo,
+            clientUrl: uploadedInfo.url,
+            deprecatedMms3Url: uploadedInfo.url,
+            uploadhash: uploadedInfo.encFilehash,
+            size: file.size,
+            type: 'sticker',
+            filehash
+        };
+
+        return stickerInfo;
+    };
+
+    window.WWebJS.processMediaData = async (mediaInfo, { forceVoice, forceDocument, forceGif }) => {
+        const file = window.WWebJS.mediaInfoToFile(mediaInfo);
+        const mData = await window.Store.OpaqueData.createFromData(file, file.type);
+        const mediaPrep = window.Store.MediaPrep.prepRawMedia(mData, { asDocument: forceDocument });
+        const mediaData = await mediaPrep.waitForPrep();
+        const mediaObject = window.Store.MediaObject.getOrCreateMediaObject(mediaData.filehash);
+
+        const mediaType = window.Store.MediaTypes.msgToMediaType({
+            type: mediaData.type,
+            isGif: mediaData.isGif
+        });
+
+        if (forceVoice && mediaData.type === 'audio') {
+            mediaData.type = 'ptt';
+            const waveform = mediaObject.contentInfo.waveform;
+            mediaData.waveform =
+                waveform ?? await window.WWebJS.generateWaveform(file);
+        }
+
+        if (forceGif && mediaData.type === 'video') {
+            mediaData.isGif = true;
+        }
+
+        if (forceDocument) {
+            mediaData.type = 'document';
+        }
+
+        if (!(mediaData.mediaBlob instanceof window.Store.OpaqueData)) {
+            mediaData.mediaBlob = await window.Store.OpaqueData.createFromData(mediaData.mediaBlob, mediaData.mediaBlob.type);
+        }
+
+        mediaData.renderableUrl = mediaData.mediaBlob.url();
+        mediaObject.consolidate(mediaData.toJSON());
+        mediaData.mediaBlob.autorelease();
+
+        const uploadedMedia = await window.Store.MediaUpload.uploadMedia({
+            mimetype: mediaData.mimetype,
+            mediaObject,
+            mediaType
+        });
+
+        const mediaEntry = uploadedMedia.mediaEntry;
+        if (!mediaEntry) {
+            throw new Error('upload failed: media entry was not created');
+        }
+
+        mediaData.set({
+            clientUrl: mediaEntry.mmsUrl,
+            deprecatedMms3Url: mediaEntry.deprecatedMms3Url,
+            directPath: mediaEntry.directPath,
+            mediaKey: mediaEntry.mediaKey,
+            mediaKeyTimestamp: mediaEntry.mediaKeyTimestamp,
+            filehash: mediaObject.filehash,
+            encFilehash: mediaEntry.encFilehash,
+            uploadhash: mediaEntry.uploadHash,
+            size: mediaObject.size,
+            streamingSidecar: mediaEntry.sidecar,
+            firstFrameSidecar: mediaEntry.firstFrameSidecar
+        });
+
+        return mediaData;
+    };
+
+    window.WWebJS.getMessageModel = message => {
+        const msg = message.serialize();
+
+        msg.isEphemeral = message.isEphemeral;
+        msg.isStatusV3 = message.isStatusV3;
+        msg.links = (message.getRawLinks()).map(link => ({
+            link: link.href,
+            isSuspicious: Boolean(link.suspiciousCharacters && link.suspiciousCharacters.size)
+        }));
+
+        if (msg.buttons) {
+            msg.buttons = msg.buttons.serialize();
+        }
+        if (msg.dynamicReplyButtons) {
+            msg.dynamicReplyButtons = JSON.parse(JSON.stringify(msg.dynamicReplyButtons));
+        }
+        if (msg.replyButtons) {
+            msg.replyButtons = JSON.parse(JSON.stringify(msg.replyButtons));
+        }
+
+        if (typeof msg.id.remote === 'object') {
+            msg.id = Object.assign({}, msg.id, { remote: msg.id.remote._serialized });
+        }
+
+        delete msg.pendingAckUpdate;
+
+        return msg;
+    };
+
+
+    window.WWebJS.getChatModel = async chat => {
+
+        let res = chat.serialize();
+        res.isGroup = chat.isGroup;
+        res.formattedTitle = chat.formattedTitle;
+        res.isMuted = chat.mute && chat.mute.isMuted;
+
+        if (chat.groupMetadata) {
+            const chatWid = window.Store.WidFactory.createWid((chat.id._serialized));
+            await window.Store.GroupMetadata.update(chatWid);
+            res.groupMetadata = chat.groupMetadata.serialize();
+        }
+        
+        res.lastMessage = null;
+        if (res.msgs && res.msgs.length) {
+            const lastMessage = chat.lastReceivedKey ? window.Store.Msg.get(chat.lastReceivedKey._serialized) : null;
+            if (lastMessage) {
+                res.lastMessage = window.WWebJS.getMessageModel(lastMessage);
+            }
+        }
+        
+        delete res.msgs;
+        delete res.msgUnsyncedButtonReplyMsgs;
+        delete res.unsyncedButtonReplies;
+
+        return res;
+    };
+
+    window.WWebJS.getChat = async chatId => {
+        const chatWid = window.Store.WidFactory.createWid(chatId);
+        const chat = await window.Store.Chat.find(chatWid);
+        return await window.WWebJS.getChatModel(chat);
+    };
+
+    window.WWebJS.getChats = async () => {
+        const chats = window.Store.Chat.getModelsArray();
+
+        const chatPromises = chats.map(chat => window.WWebJS.getChatModel(chat));
+        return await Promise.all(chatPromises);
+    };
+
+    window.WWebJS.getContactModel = contact => {
+        let res = contact.serialize();
+        res.isBusiness = contact.isBusiness === undefined ? false : contact.isBusiness;
+
+        if (contact.businessProfile) {
+            res.businessProfile = contact.businessProfile.serialize();
+        }
+
+        // TODO: remove useOldImplementation and its checks once all clients are updated to >= v2.2327.4
+        const useOldImplementation
+            = window.compareWwebVersions(window.Debug.VERSION, '<', '2.2327.4');
+
+        res.isMe = useOldImplementation
+            ? contact.isMe
+            : window.Store.ContactMethods.getIsMe(contact);
+        res.isUser = useOldImplementation
+            ? contact.isUser
+            : window.Store.ContactMethods.getIsUser(contact);
+        res.isGroup = useOldImplementation
+            ? contact.isGroup
+            : window.Store.ContactMethods.getIsGroup(contact);
+        res.isWAContact = useOldImplementation
+            ? contact.isWAContact
+            : window.Store.ContactMethods.getIsWAContact(contact);
+        res.isMyContact = useOldImplementation
+            ? contact.isMyContact
+            : window.Store.ContactMethods.getIsMyContact(contact);
+        res.isBlocked = contact.isContactBlocked;
+        res.userid = useOldImplementation
+            ? contact.userid
+            : window.Store.ContactMethods.getUserid(contact);
+        res.isEnterprise = useOldImplementation
+            ? contact.isEnterprise
+            : window.Store.ContactMethods.getIsEnterprise(contact);
+        res.verifiedName = useOldImplementation
+            ? contact.verifiedName
+            : window.Store.ContactMethods.getVerifiedName(contact);
+        res.verifiedLevel = useOldImplementation
+            ? contact.verifiedLevel
+            : window.Store.ContactMethods.getVerifiedLevel(contact);
+        res.statusMute = useOldImplementation
+            ? contact.statusMute
+            : window.Store.ContactMethods.getStatusMute(contact);
+        res.name = useOldImplementation
+            ? contact.name
+            : window.Store.ContactMethods.getName(contact);
+        res.shortName = useOldImplementation
+            ? contact.shortName
+            : window.Store.ContactMethods.getShortName(contact);
+        res.pushname = useOldImplementation
+            ? contact.pushname
+            : window.Store.ContactMethods.getPushname(contact);
+
+        return res;
+    };
+
+    window.WWebJS.getContact = async contactId => {
+        const wid = window.Store.WidFactory.createWid(contactId);
+        const contact = await window.Store.Contact.find(wid);
+        const bizProfile = await window.Store.BusinessProfileCollection.fetchBizProfile(wid);
+        bizProfile.profileOptions && (contact.businessProfile = bizProfile);
+        return window.WWebJS.getContactModel(contact);
+    };
+
+    window.WWebJS.getContacts = () => {
+        const contacts = window.Store.Contact.getModelsArray();
+        return contacts.map(contact => window.WWebJS.getContactModel(contact));
+    };
+
+    window.WWebJS.mediaInfoToFile = ({ data, mimetype, filename }) => {
+        const binaryData = window.atob(data);
+
+        const buffer = new ArrayBuffer(binaryData.length);
+        const view = new Uint8Array(buffer);
+        for (let i = 0; i < binaryData.length; i++) {
+            view[i] = binaryData.charCodeAt(i);
+        }
+
+        const blob = new Blob([buffer], { type: mimetype });
+        return new File([blob], filename, {
+            type: mimetype,
+            lastModified: Date.now()
+        });
+    };
+
+    window.WWebJS.arrayBufferToBase64 = (arrayBuffer) => {
+        let binary = '';
+        const bytes = new Uint8Array(arrayBuffer);
+        const len = bytes.byteLength;
+        for (let i = 0; i < len; i++) {
+            binary += String.fromCharCode(bytes[i]);
+        }
+        return window.btoa(binary);
+    };
+
+    window.WWebJS.arrayBufferToBase64Async = (arrayBuffer) =>
+        new Promise((resolve, reject) => {
+            const blob = new Blob([arrayBuffer], {
+                type: 'application/octet-stream',
+            });
+            const fileReader = new FileReader();
+            fileReader.onload = () => {
+                const [, data] = fileReader.result.split(',');
+                resolve(data);
+            };
+            fileReader.onerror = (e) => reject(e);
+            fileReader.readAsDataURL(blob);
+        });
+
+    window.WWebJS.getFileHash = async (data) => {
+        let buffer = await data.arrayBuffer();
+        const hashBuffer = await crypto.subtle.digest('SHA-256', buffer);
+        return btoa(String.fromCharCode(...new Uint8Array(hashBuffer)));
+    };
+
+    window.WWebJS.generateHash = async (length) => {
+        var result = '';
+        var characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+        var charactersLength = characters.length;
+        for (var i = 0; i < length; i++) {
+            result += characters.charAt(Math.floor(Math.random() * charactersLength));
+        }
+        return result;
+    };
+
+    /**
+     * Referenced from and modified:
+     * @see https://github.com/wppconnect-team/wa-js/commit/290ebfefe6021b3d17f7fdfdda5545bb0473b26f
+     */
+    window.WWebJS.generateWaveform = async (audioFile) => {
+        try {
+            const audioData = await audioFile.arrayBuffer();
+            const audioContext = new AudioContext();
+            const audioBuffer = await audioContext.decodeAudioData(audioData);
+
+            const rawData = audioBuffer.getChannelData(0);
+            const samples = 64;
+            const blockSize = Math.floor(rawData.length / samples);
+            const filteredData = [];
+            for (let i = 0; i < samples; i++) {
+                const blockStart = blockSize * i;
+                let sum = 0;
+                for (let j = 0; j < blockSize; j++) {
+                    sum = sum + Math.abs(rawData[blockStart + j]);
+                }
+                filteredData.push(sum / blockSize);
+            }
+
+            const multiplier = Math.pow(Math.max(...filteredData), -1);
+            const normalizedData = filteredData.map((n) => n * multiplier);
+
+            const waveform = new Uint8Array(
+                normalizedData.map((n) => Math.floor(100 * n))
+            );
+
+            return waveform;
+        } catch (e) {
+            return undefined;
+        }
+    };
+
+    window.WWebJS.sendClearChat = async (chatId) => {
+        let chat = window.Store.Chat.get(chatId);
+        if (chat !== undefined) {
+            await window.Store.SendClear.sendClear(chat, false);
+            return true;
+        }
+        return false;
+    };
+
+    window.WWebJS.sendDeleteChat = async (chatId) => {
+        let chat = window.Store.Chat.get(chatId);
+        if (chat !== undefined) {
+            await window.Store.SendDelete.sendDelete(chat);
+            return true;
+        }
+        return false;
+    };
+
+    window.WWebJS.sendChatstate = async (state, chatId) => {
+        if (window.Store.MDBackend) {
+            chatId = window.Store.WidFactory.createWid(chatId);
+        }
+        switch (state) {
+        case 'typing':
+            await window.Store.ChatState.sendChatStateComposing(chatId);
+            break;
+        case 'recording':
+            await window.Store.ChatState.sendChatStateRecording(chatId);
+            break;
+        case 'stop':
+            await window.Store.ChatState.sendChatStatePaused(chatId);
+            break;
+        default:
+            throw 'Invalid chatstate';
+        }
+
+        return true;
+    };
+
+    window.WWebJS.getLabelModel = label => {
+        let res = label.serialize();
+        res.hexColor = label.hexColor;
+
+        return res;
+    };
+
+    window.WWebJS.getLabels = () => {
+        const labels = window.Store.Label.getModelsArray();
+        return labels.map(label => window.WWebJS.getLabelModel(label));
+    };
+
+    window.WWebJS.getLabel = (labelId) => {
+        const label = window.Store.Label.get(labelId);
+        return window.WWebJS.getLabelModel(label);
+    };
+
+    window.WWebJS.getChatLabels = async (chatId) => {
+        const chat = await window.WWebJS.getChat(chatId);
+        return (chat.labels || []).map(id => window.WWebJS.getLabel(id));
+    };
+
+    window.WWebJS.getOrderDetail = async (orderId, token, chatId) => {
+        const chatWid = window.Store.WidFactory.createWid(chatId);
+        return window.Store.QueryOrder.queryOrder(chatWid, orderId, 80, 80, token);
+    };
+
+    window.WWebJS.getProductMetadata = async (productId) => {
+        let sellerId = window.Store.Conn.wid;
+        let product = await window.Store.QueryProduct.queryProduct(sellerId, productId);
+        if (product && product.data) {
+            return product.data;
+        }
+
+        return undefined;
+    };
+
+    window.WWebJS.rejectCall = async (peerJid, id) => {
+        peerJid = peerJid.split('@')[0] + '@s.whatsapp.net';
+        let userId = window.Store.User.getMaybeMeUser().user + '@s.whatsapp.net';
+        const stanza = window.Store.SocketWap.wap('call', {
+            id: window.Store.SocketWap.generateId(),
+            from: window.Store.SocketWap.USER_JID(userId),
+            to: window.Store.SocketWap.USER_JID(peerJid),
+        }, [
+            window.Store.SocketWap.wap('reject', {
+                'call-id': id,
+                'call-creator': window.Store.SocketWap.USER_JID(peerJid),
+                count: '0',
+            })
+        ]);
+        await window.Store.Socket.deprecatedCastStanza(stanza);
+    };
+
+    window.WWebJS.cropAndResizeImage = async (media, options = {}) => {
+        if (!media.mimetype.includes('image'))
+            throw new Error('Media is not an image');
+
+        if (options.mimetype && !options.mimetype.includes('image'))
+            delete options.mimetype;
+
+        options = Object.assign({ size: 640, mimetype: media.mimetype, quality: .75, asDataUrl: false }, options);
+
+        const img = await new Promise ((resolve, reject) => {
+            const img = new Image();
+            img.onload = () => resolve(img);
+            img.onerror = reject;
+            img.src = `data:${media.mimetype};base64,${media.data}`;
+        });
+
+        const sl = Math.min(img.width, img.height);
+        const sx = Math.floor((img.width - sl) / 2);
+        const sy = Math.floor((img.height - sl) / 2);
+
+        const canvas = document.createElement('canvas');
+        canvas.width = options.size;
+        canvas.height = options.size;
+
+        const ctx = canvas.getContext('2d');
+        ctx.drawImage(img, sx, sy, sl, sl, 0, 0, options.size, options.size);
+
+        const dataUrl = canvas.toDataURL(options.mimetype, options.quality);
+
+        if (options.asDataUrl)
+            return dataUrl;
+
+        return Object.assign(media, {
+            mimetype: options.mimeType,
+            data: dataUrl.replace(`data:${options.mimeType};base64,`, '')
+        });
+    };
+
+    window.WWebJS.setPicture = async (chatid, media) => {
+        const thumbnail = await window.WWebJS.cropAndResizeImage(media, { asDataUrl: true, mimetype: 'image/jpeg', size: 96 });
+        const profilePic = await window.WWebJS.cropAndResizeImage(media, { asDataUrl: true, mimetype: 'image/jpeg', size: 640 });
+
+        const chatWid = window.Store.WidFactory.createWid(chatid);
+        try {
+            const collection = window.Store.ProfilePicThumb.get(chatid);
+            if (!collection.canSet()) return;
+
+            const res = await window.Store.GroupUtils.sendSetPicture(chatWid, thumbnail, profilePic);
+            return res ? res.status === 200 : false;
+        } catch (err) {
+            if(err.name === 'ServerStatusCodeError') return false;
+            throw err;
+        }
+    };
+
+    window.WWebJS.deletePicture = async (chatid) => {
+        const chatWid = window.Store.WidFactory.createWid(chatid);
+        try {
+            const collection = window.Store.ProfilePicThumb.get(chatid);
+            if (!collection.canDelete()) return;
+
+            const res = await window.Store.GroupUtils.requestDeletePicture(chatWid);
+            return res ? res.status === 200 : false;
+        } catch (err) {
+            if(err.name === 'ServerStatusCodeError') return false;
+            throw err;
+        }
+    };
+    
+    window.WWebJS.getProfilePicThumbToBase64 = async (chatWid) => {
+        const profilePicCollection = await window.Store.ProfilePicThumb.find(chatWid);
+
+        const _readImageAsBase64 = (imageBlob) => {
+            return new Promise((resolve) => {
+                const reader = new FileReader();
+                reader.onloadend = function () {
+                    const base64Image = reader.result;
+                    if (base64Image == null) {
+                        resolve(undefined);
+                    } else {
+                        const base64Data = base64Image.toString().split(',')[1];
+                        resolve(base64Data);
+                    }
+                };
+                reader.readAsDataURL(imageBlob);
+            });
+        };
+
+        if (profilePicCollection?.img) {
+            try {
+                const response = await fetch(profilePicCollection.img);
+                if (response.ok) {
+                    const imageBlob = await response.blob();
+                    if (imageBlob) {
+                        const base64Image = await _readImageAsBase64(imageBlob);
+                        return base64Image;
+                    }
+                }
+            } catch (error) { /* empty */ }
+        }
+        return undefined;
+    };
+
+    window.WWebJS.getAddParticipantsRpcResult = async (groupMetadata, groupWid, participantWid) => {
+        const participantLidArgs = groupMetadata?.isLidAddressingMode
+            ? {
+                phoneNumber: participantWid,
+                lid: window.Store.LidUtils.getCurrentLid(participantWid)
+            }
+            : { phoneNumber: participantWid };
+
+        const iqTo = window.Store.WidToJid.widToGroupJid(groupWid);
+
+        const participantArgs =
+            participantLidArgs.lid
+                ? [{
+                    participantJid: window.Store.WidToJid.widToUserJid(participantLidArgs.lid),
+                    phoneNumberMixinArgs: {
+                        anyPhoneNumber: window.Store.WidToJid.widToUserJid(participantLidArgs.phoneNumber)
+                    }
+                }]
+                : [{
+                    participantJid: window.Store.WidToJid.widToUserJid(participantLidArgs.phoneNumber)
+                }];
+
+        let rpcResult, resultArgs;
+        const isOldImpl = window.compareWwebVersions(window.Debug.VERSION, '<=', '2.2335.9');
+        const data = {
+            name: undefined,
+            code: undefined,
+            inviteV4Code: undefined,
+            inviteV4CodeExp: undefined
+        };
+
+        try {
+            rpcResult = await window.Store.GroupParticipants.sendAddParticipantsRPC({ participantArgs, iqTo });
+            resultArgs = isOldImpl
+                ? rpcResult.value.addParticipant[0].addParticipantsParticipantMixins
+                : rpcResult.value.addParticipant[0]
+                    .addParticipantsParticipantAddedOrNonRegisteredWaUserParticipantErrorLidResponseMixinGroup
+                    .value
+                    .addParticipantsParticipantMixins;
+        } catch (err) {
+            data.code = 400;
+            return data;
+        }
+
+        if (rpcResult.name === 'AddParticipantsResponseSuccess') {
+            const code = resultArgs?.value.error ?? '200';
+            data.name = resultArgs?.name;
+            data.code = +code;
+            data.inviteV4Code = resultArgs?.value.addRequestCode;
+            data.inviteV4CodeExp = resultArgs?.value.addRequestExpiration?.toString();
+        }
+
+        else if (rpcResult.name === 'AddParticipantsResponseClientError') {
+            const { code: code } = rpcResult.value.errorAddParticipantsClientErrors.value;
+            data.code = +code;
+        }
+
+        else if (rpcResult.name === 'AddParticipantsResponseServerError') {
+            const { code: code } = rpcResult.value.errorServerErrors.value;
+            data.code = +code;
+        }
+
+        return data;
+    };
+
+    window.WWebJS.membershipRequestAction = async (groupId, action, requesterIds, sleep) => {
+        const groupWid = window.Store.WidFactory.createWid(groupId);
+        const group = await window.Store.Chat.find(groupWid);
+        const toApprove = action === 'Approve';
+        let membershipRequests;
+        let response;
+        let result = [];
+
+        await window.Store.GroupMetadata.queryAndUpdate(groupWid);
+
+        if (!requesterIds?.length) {
+            membershipRequests = group.groupMetadata.membershipApprovalRequests._models.map(({ id }) => id);
+        } else {
+            !Array.isArray(requesterIds) && (requesterIds = [requesterIds]);
+            membershipRequests = requesterIds.map(r => window.Store.WidFactory.createWid(r));
+        }
+
+        if (!membershipRequests.length) return [];
+
+        const participantArgs = membershipRequests.map(m => ({
+            participantArgs: [
+                {
+                    participantJid: window.Store.WidToJid.widToUserJid(m)
+                }
+            ]
+        }));
+
+        const groupJid = window.Store.WidToJid.widToGroupJid(groupWid);
+        
+        const _getSleepTime = (sleep) => {
+            if (!Array.isArray(sleep) || (sleep.length === 2 && sleep[0] === sleep[1])) {
+                return sleep;
+            }
+            if (sleep.length === 1) {
+                return sleep[0];
+            }
+            sleep[1] - sleep[0] < 100 && (sleep[0] = sleep[1]) && (sleep[1] += 100);
+            return Math.floor(Math.random() * (sleep[1] - sleep[0] + 1)) + sleep[0];
+        };
+
+        const membReqResCodes = {
+            default: `An unknown error occupied while ${toApprove ? 'approving' : 'rejecting'} the participant membership request`,
+            400: 'ParticipantNotFoundError',
+            401: 'ParticipantNotAuthorizedError',
+            403: 'ParticipantForbiddenError',
+            404: 'ParticipantRequestNotFoundError',
+            408: 'ParticipantTemporarilyBlockedError',
+            409: 'ParticipantConflictError',
+            412: 'ParticipantParentLinkedGroupsResourceConstraintError',
+            500: 'ParticipantResourceConstraintError'
+        };
+
+        try {
+            for (const participant of participantArgs) {
+                response = await window.Store.MembershipRequestUtils.sendMembershipRequestsActionRPC({
+                    iqTo: groupJid,
+                    [toApprove ? 'approveArgs' : 'rejectArgs']: participant
+                });
+
+                if (response.name === 'MembershipRequestsActionResponseSuccess') {
+                    const value = toApprove
+                        ? response.value.membershipRequestsActionApprove
+                        : response.value.membershipRequestsActionReject;
+                    if (value?.participant) {
+                        const [_] = value.participant.map(p => {
+                            const error = toApprove
+                                ? value.participant[0].membershipRequestsActionAcceptParticipantMixins?.value.error
+                                : value.participant[0].membershipRequestsActionRejectParticipantMixins?.value.error;
+                            return {
+                                requesterId: window.Store.WidFactory.createWid(p.jid)._serialized,
+                                ...(error
+                                    ? { error: +error, message: membReqResCodes[error] || membReqResCodes.default }
+                                    : { message: `${toApprove ? 'Approved' : 'Rejected'} successfully` })
+                            };
+                        });
+                        _ && result.push(_);
+                    }
+                } else {
+                    result.push({
+                        requesterId: window.Store.JidToWid.userJidToUserWid(participant.participantArgs[0].participantJid)._serialized,
+                        message: 'ServerStatusCodeError'
+                    });
+                }
+
+                sleep &&
+                    participantArgs.length > 1 &&
+                    participantArgs.indexOf(participant) !== participantArgs.length - 1 &&
+                    (await new Promise((resolve) => setTimeout(resolve, _getSleepTime(sleep))));
+            }
+            return result;
+        } catch (err) {
+            return [];
+        }
+    };
+};
+
+
+
+
+ +
+
+
+ +
+ + + + + + + + + \ No newline at end of file diff --git a/docs/util_InterfaceController.js.html b/docs/util_InterfaceController.js.html index d51d7f6..9c0196c 100644 --- a/docs/util_InterfaceController.js.html +++ b/docs/util_InterfaceController.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: util/InterfaceController.js + whatsapp-web.js 1.23.0 » Source: util/InterfaceController.js @@ -15,7 +15,7 @@ @@ -166,7 +166,7 @@ module.exports = InterfaceController;
diff --git a/docs/util_Util.js.html b/docs/util_Util.js.html index bf20fb9..d8ce40d 100644 --- a/docs/util_Util.js.html +++ b/docs/util_Util.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: util/Util.js + whatsapp-web.js 1.23.0 » Source: util/Util.js @@ -15,7 +15,7 @@ @@ -225,7 +225,7 @@ module.exports = Util;
diff --git a/docs/webCache_LocalWebCache.js.html b/docs/webCache_LocalWebCache.js.html index 548556e..ccdb09d 100644 --- a/docs/webCache_LocalWebCache.js.html +++ b/docs/webCache_LocalWebCache.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: webCache/LocalWebCache.js + whatsapp-web.js 1.23.0 » Source: webCache/LocalWebCache.js @@ -15,7 +15,7 @@ @@ -81,7 +81,7 @@ module.exports = LocalWebCache;
diff --git a/docs/webCache_RemoteWebCache.js.html b/docs/webCache_RemoteWebCache.js.html index a25746d..75a643e 100644 --- a/docs/webCache_RemoteWebCache.js.html +++ b/docs/webCache_RemoteWebCache.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: webCache/RemoteWebCache.js + whatsapp-web.js 1.23.0 » Source: webCache/RemoteWebCache.js @@ -15,7 +15,7 @@ @@ -78,7 +78,7 @@ module.exports = RemoteWebCache;
diff --git a/docs/webCache_WebCache.js.html b/docs/webCache_WebCache.js.html index b8f759b..a19a40e 100644 --- a/docs/webCache_WebCache.js.html +++ b/docs/webCache_WebCache.js.html @@ -4,7 +4,7 @@ - whatsapp-web.js 1.22.1 » Source: webCache/WebCache.js + whatsapp-web.js 1.23.0 » Source: webCache/WebCache.js @@ -15,7 +15,7 @@ @@ -52,7 +52,7 @@ module.exports = { diff --git a/package.json b/package.json index f62a128..ab6f473 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "whatsapp-web.js", - "version": "1.22.2-alpha.4", + "version": "1.23.0", "description": "Library for interacting with the WhatsApp Web API ", "main": "./index.js", "typings": "./index.d.ts",