@wppconnect/wa-js 4.3.1-alpha.0 → 4.3.1

package/CHANGELOG.md

@@ -1,3 +1,3 @@
-## <small>4.3.1-alpha.0 (2026-06-04)</small>
+## <small>4.3.1 (2026-06-19)</small>
 
-* fix: unknown on chat list ([a8bd92d2b381d56ca5b96c392f71aa81d7ff0c70](https://github.com/wppconnect-team/wa-js/commit/a8bd92d2b381d56ca5b96c392f71aa81d7ff0c70))
+* fix(group): pass membershipApprovalMode to joinGroupViaInvite (#3468) ([3383b0374789dd25564068669bd2caadc25c0f5a](https://github.com/wppconnect-team/wa-js/commit/3383b0374789dd25564068669bd2caadc25c0f5a)), closes [#3468](https://github.com/wppconnect-team/wa-js/issues/3468) [#2221](https://github.com/wppconnect-team/wa-js/issues/2221)

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/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/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;