@wppconnect/wa-js 4.3.2-alpha.0 → 4.4.0

package/CHANGELOG.md

@@ -1,3 +1,3 @@
-## <small>4.3.2-alpha.0 (2026-06-04)</small>
+## 4.4.0 (2026-07-15)
 
-* Merge branch 'manfe/fix-unknown-on-chat-list' of github.com:wppconnect-team/wa-js into manfe/fix-unknown-on-chat-list ([c444c5bf8c6ce23ffa3edddbd6feb5ef749a6baa](https://github.com/wppconnect-team/wa-js/commit/c444c5bf8c6ce23ffa3edddbd6feb5ef749a6baa))
+* fix: restore MsgKey._serialized on WhatsApp Web >= 2.3000.1042401057 (#3484) ([dd00bf71ca807b36bddedb0628b139e5d7d70450](https://github.com/wppconnect-team/wa-js/commit/dd00bf71ca807b36bddedb0628b139e5d7d70450)), closes [#3484](https://github.com/wppconnect-team/wa-js/issues/3484)

package/dist/call/functions/end.d.ts

@@ -14,23 +14,14 @@
  * limitations under the License.
  */
 /**
- * End a call
+ * End a call using the WhatsApp Web native VoIP stack
  *
  * @example
  * ```javascript
  * // End any call
  * WPP.call.end();
- *
- * // End specific call id
- * WPP.call.end(callId);
- *
- * // End any incoming call
- * WPP.on('call.incoming_call', (call) => {
- *   WPP.call.end(call.id);
- * });
  * ```
  *
- * @param   {string}  callId  The call ID, empty to end the first one
- * @return  {[type]}          [return description]
+ * @return  {Promise<boolean>}
  */
-export declare function end(callId?: string): Promise<boolean>;
+export declare function end(): Promise<boolean>;

package/dist/call/functions/offer.d.ts

@@ -18,9 +18,7 @@ export interface CallOfferOptions {
     isVideo?: boolean;
 }
 /**
- * Send a call offer
- *
- * This method only will send a call offer, but there are no audio/video
+ * Send a call offer using the WhatsApp Web native VoIP stack
  *
  * @example
  * ```javascript

package/dist/group/functions/join.d.ts

@@ -13,16 +13,32 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+/**
+ * Result returned by {@link join}.
+ *
+ * `pendingApproval` is `true` when the group has `membershipApprovalMode`
+ * enabled and the join request was submitted successfully but still requires
+ * an admin to approve it before the bot becomes a member.
+ */
+export interface JoinGroupResult {
+    id: string;
+    pendingApproval: boolean;
+}
 /**
  * Join in a group from an invite code.
  *
+ * When the group requires admin approval (`membershipApprovalMode: true`),
+ * the method returns `{ id, pendingApproval: true }` instead of throwing
+ * `UnexpectedJoinGroupViaInviteResponse` (issues #2221 / #2746).
+ *
  * @example
  * ```javascript
- * await WPP.group.join('abcde....');
+ * const result = await WPP.group.join('abcde....');
+ * if (result.pendingApproval) {
+ *   console.log('Request sent — waiting for admin approval');
+ * }
  * ```
  *
  * @category Group
  */
-export declare function join(inviteCode: string): Promise<{
-    id: string;
-}>;
+export declare function join(inviteCode: string): Promise<JoinGroupResult>;

package/dist/whatsapp/functions/getVoipStackInterface.d.ts

@@ -0,0 +1,19 @@
+/*!
+ * Copyright 2026 WPPConnect Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @whatsapp WAWebVoipStackInterface
+ */
+export declare function getVoipStackInterface(): Promise<any>;

package/dist/whatsapp/functions/index.d.ts

@@ -91,6 +91,7 @@ export * from './getSearchContext';
 export * from './getShouldAppearInList';
 export * from './getStatusList';
 export * from './getTableVotes';
+export * from './getVoipStackInterface';
 export * from './getVotes';
 export * from './getWhatsAppWebExternalBetaJoinedIdb';
 export * from './GROUP_JID';
@@ -165,6 +166,7 @@ export * from './setPin';
 export * from './setPrivacyForOneCategory';
 export * from './setPushname';
 export * from './shouldHaveAccountLid';
+export * from './startWAWebVoipCall';
 export * from './status';
 export * from './STATUS_JID';
 export * from './statusEnable';
@@ -185,4 +187,7 @@ export * from './uploadMedia';
 export * from './uploadProductImage';
 export * from './uploadThumbnail';
 export * from './upsertVotes';
+export * from './useExternalBetaOptIn';
+export * from './voipBackend';
+export * from './voipGating';
 export * from './voteFromDbRow';

package/dist/whatsapp/functions/joinGroupViaInvite.d.ts

@@ -16,7 +16,12 @@
 import { Wid } from '..';
 /**
  * @whatsapp 153438 >= 2.2301.5
+ *
+ * When `membershipApprovalMode` is `false` (default) the server must respond
+ * with a `<group>` node; when `true` it must respond with
+ * `<membership_approval_request>`.  If the wrong node is returned the function
+ * throws `UnexpectedJoinGroupViaInviteResponse` (see WAWebBackendErrors).
  */
-export declare function joinGroupViaInvite(groupId: Wid): Promise<{
+export declare function joinGroupViaInvite(code: string, membershipApprovalMode: boolean): Promise<{
     gid: Wid;
 }>;

package/dist/whatsapp/functions/sendJoinGroupViaInvite.d.ts

@@ -14,7 +14,18 @@
  * limitations under the License.
  */
 import { Wid } from '..';
+/**
+ * Result shape returned by {@link sendJoinGroupViaInvite}.
+ *
+ * `membershipApprovalMode` mirrors the flag queried via
+ * `getGroupInfoFromInviteCode` and signals whether the bot's join request is
+ * pending admin approval (`true`) or the bot joined immediately (`false`).
+ */
+export interface SendJoinGroupViaInviteResult {
+    gid: Wid;
+    membershipApprovalMode: boolean;
+}
 /** @whatsapp 69586
  * @whatsapp 769586 >= 2.2222.8
  */
-export declare function sendJoinGroupViaInvite(code: string): Promise<Wid>;
+export declare function sendJoinGroupViaInvite(code: string): Promise<SendJoinGroupViaInviteResult>;

package/dist/whatsapp/functions/startWAWebVoipCall.d.ts

@@ -0,0 +1,20 @@
+/*!
+ * Copyright 2026 WPPConnect Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Wid } from '../misc';
+/**
+ * @whatsapp WAWebVoipStartCall
+ */
+export declare function startWAWebVoipCall(peerWid: Wid, isVideo: boolean, lobbyEntryPoint: number, channel: number): Promise<any>;

package/dist/whatsapp/functions/useExternalBetaOptIn.d.ts

@@ -0,0 +1,21 @@
+/*!
+ * Copyright 2021 WPPConnect Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @whatsapp 95547
+ * @whatsapp 695547 >= 2.2222.8
+ * @whatsapp 925080 >= 2.2228.4
+ */
+export declare function useExternalBetaOptIn(value: any): any;

package/dist/whatsapp/functions/voipBackend.d.ts

@@ -0,0 +1,19 @@
+/*!
+ * Copyright 2026 WPPConnect Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @whatsapp WAWebVoipBackendLoadable
+ */
+export declare function requireVoipJsBackend(): Promise<any>;

package/dist/whatsapp/functions/voipGating.d.ts

@@ -0,0 +1,22 @@
+/*!
+ * Copyright 2026 WPPConnect Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @whatsapp WAWebVoipGatingUtils
+ */
+export declare function isCallingEnabled(): boolean;
+export declare function isUnsupportedBrowserForWebCalling(): boolean;
+export declare function isVoipDownloadEnabled(): boolean;
+export declare function getUnsupportedBrowserReason(): string | null;

package/dist/whatsapp/models/ChatModel.d.ts

@@ -39,8 +39,6 @@ interface Props extends PropsChatBase {
     unreadMentionsOfMe?: any;
     msgUnsyncedButtonReplyMsgs?: any;
     endOfHistoryTransferType?: any;
-    /** Contact LID for PnLess protocol (Phone Number-less) */
-    accountLid?: Wid;
 }
 interface Session extends SessionChatBase {
     stale?: any;