@badzz88/baileys 8.5.4 → 8.5.5

package/lib/Socket/groups.js

@@ -9,28 +9,28 @@ const chats_1 = require('./chats')
 const mex_1 = require('./mex')
 
 const GROUP_MEX_QUERY_IDS = {
-	QUERY_INFO: '25530136513328492', 
-	QUERY_INFO_BY_CODE: '24576337542042464', 
-	QUERY_BATCH: '26440064815661176', 
-	QUERY_INVITE_LINK: '24558418350455204', 
-	QUERY_PARTICIPATING: '26664341543184776', 
-	QUERY_SUGGESTED: '26012055225051916', 
-	QUERY_LINKED: '25629003043401452', 
-	QUERY_SUBGROUPS: '25554052094203120', 
-	ADD_PARTICIPANTS_V2: '32627550323510250', 
-	ADD_PARTICIPANTS_V3: '26581073158212628', 
-	SET_PROPERTY: '24688994337458820', 
-	RESET_INVITE_LINK: '24812851838367452', 
-	CREATE_INVITE_CODE: '25207706598901440', 
-	CREATE_GROUP: '32341779532133480', 
-	ALLOW_NON_ADMIN_GROUP_CREATION: '32024438593867696', 
-	GET_INVITE_INFO: '24745668928467084', 
-	GET_PRE_REG_ADD_REQUESTS: '25018599251091280', 
-	GET_SUGGESTED_CONTACTS: '27208468032086900', 
-	STORE_INVITES_SMS: '25508574885415376', 
-	LOG_SERVER_SENT_INVITE: '26580640204871220', 
-	QUERY_ONLINE_STATUS: '24599444653063564', 
-	QUERY_ONLINE_STATUS_LAST_SEEN: '24653084284365540' 
+	QUERY_INFO: '25530136513328492', // QueryGroupInfo
+	QUERY_INFO_BY_CODE: '24576337542042464', // QueryGroupInfoByCode
+	QUERY_BATCH: '26440064815661176', // QueryBatchGetGroups
+	QUERY_INVITE_LINK: '24558418350455204', // QueryInviteLink
+	QUERY_PARTICIPATING: '26664341543184776', // QueryParticipatingGroups
+	QUERY_SUGGESTED: '26012055225051916', // QuerySuggestedGroups
+	QUERY_LINKED: '25629003043401452', // QueryLinkedGroupInfo
+	QUERY_SUBGROUPS: '25554052094203120', // QuerySubgroups
+	ADD_PARTICIPANTS_V2: '32627550323510250', // AddParticipantsToGroupV2
+	ADD_PARTICIPANTS_V3: '26581073158212628', // AddParticipantsToGroupsV3
+	SET_PROPERTY: '24688994337458820', // SetGroupProperty
+	RESET_INVITE_LINK: '24812851838367452', // SetGroupResetInviteLink
+	CREATE_INVITE_CODE: '25207706598901440', // CreateInviteCode
+	CREATE_GROUP: '32341779532133480', // CreateGroup
+	ALLOW_NON_ADMIN_GROUP_CREATION: '32024438593867696', // AllowNonAdminGroupCreation
+	GET_INVITE_INFO: '24745668928467084', // GetInviteInfo
+	GET_PRE_REG_ADD_REQUESTS: '25018599251091280', // GetPreRegGroupAddRequestsQuery
+	GET_SUGGESTED_CONTACTS: '27208468032086900', // GetSuggestedContacts
+	STORE_INVITES_SMS: '25508574885415376', // GroupsStoreInvitesSMSMutation
+	LOG_SERVER_SENT_INVITE: '26580640204871220', // LogServerSentInviteIntent
+	QUERY_ONLINE_STATUS: '24599444653063564', // QueryOnlineStatusFromPDP
+	QUERY_ONLINE_STATUS_LAST_SEEN: '24653084284365540' // QueryOnlineStatusLastSeenFromPDP
 }
 
 const makeGroupsSocket = config => {
@@ -46,38 +46,25 @@ const makeGroupsSocket = config => {
 			},
 			content
 		})
-	
-	
-	
-	const persistParticipantLidMappings = async participantLists => {
-		const pairs = []
-		for (const participants of participantLists) {
-			for (const p of participants || []) {
-				if (p.phoneNumber) pairs.push({ lid: p.id, pn: p.phoneNumber })
-				else if (p.lid) pairs.push({ lid: p.lid, pn: p.id })
-			}
-		}
-		if (!pairs.length) return
-		try {
-			await sock.signalRepository.lidMapping.storeLIDPNMappings(pairs)
-		} catch (error) {
-			sock.logger?.warn?.({ error }, 'failed to store LID/PN mappings from group metadata')
-		}
-	}
 
 	const mexQuery = (variables, queryId, dataPath) =>
 		(0, mex_1.executeWMexQuery)(variables, queryId, dataPath, query, generateMessageTag)
 	const groupMetadata = async jid => {
 		const result = await groupQuery(jid, 'get', [{ tag: 'query', attrs: { request: 'interactive' } }])
-		const metadata = (0, exports.extractGroupMetadata)(result)
-		persistParticipantLidMappings([metadata.participants]).catch(() => {})
-		return metadata
+		return (0, exports.extractGroupMetadata)(result)
 	}
-	
+	/**
+	 * Acknowledge a group. Ported from WhatsApp Web's WASmaxGroupsAcknowledgeGroupRPC
+	 * (`<iq to=jid xmlns=w:g2 type=set><ack/></iq>`).
+	 */
 	const groupAcknowledge = async jid => {
 		await groupQuery(jid, 'set', [{ tag: 'ack', attrs: {} }])
 	}
-	
+	/**
+	 * Get the participants of a community's linked/sub groups. Ported from
+	 * WhatsApp Web's WASmaxGroupsGetLinkedGroupsParticipantsRPC.
+	 * @returns {Promise<Array<{ jid: string, phoneNumber?: string }>>}
+	 */
 	const groupGetLinkedParticipants = async jid => {
 		const result = await groupQuery(jid, 'get', [{ tag: 'linked_groups_participants', attrs: {} }])
 		const node = (0, WABinary_1.getBinaryNodeChild)(result, 'linked_groups_participants')
@@ -86,14 +73,26 @@ const makeGroupsSocket = config => {
 			phoneNumber: p.attrs.phone_number || p.attrs.pn || undefined
 		}))
 	}
-	
+	/**
+	 * Join a community's linked/sub group (may raise a membership approval request).
+	 * Ported from WhatsApp Web's WASmaxGroupsJoinLinkedGroupRPC.
+	 * @param {string} parentJid community/parent group to address
+	 * @param {string} linkedGroupJid linked/sub group to join
+	 * @param {string} [type]
+	 */
 	const groupJoinLinked = async (parentJid, linkedGroupJid, type) => {
 		const result = await groupQuery(parentJid, 'set', [
 			{ tag: 'join_linked_group', attrs: { jid: linkedGroupJid, ...(type ? { type } : {}) } }
 		])
 		return { approvalRequested: !!(0, WABinary_1.getBinaryNodeChild)(result, 'membership_approval_request') }
 	}
-	
+	/**
+	 * Batch-fetch group profile pictures via w:g2. Ported from WhatsApp Web's
+	 * WASmaxGroupsGetGroupProfilePicturesRPC. NOTE: untested against live WhatsApp —
+	 * for a single group prefer profilePictureUrl().
+	 * @param {string[]} jids group jids
+	 * @param {'preview' | 'image'} [type]
+	 */
 	const getGroupProfilePictures = async (jids, type = 'preview') => {
 		const result = await groupQuery(WABinary_1.S_WHATSAPP_NET, 'get', [
 			{
@@ -109,26 +108,32 @@ const makeGroupsSocket = config => {
 			url: pic.attrs.url
 		}))
 	}
-	
+	/**
+	 * Create a sub-group suggestion for a community. Ported from WhatsApp Web's
+	 * WASmaxGroupsCreateSubGroupSuggestionRPC. The suggestion body (new vs existing
+	 * groups) is caller-provided. NOTE: untested against live WhatsApp.
+	 * @param {string} parentJid community/parent group to address
+	 * @param {Array<{ tag: string, attrs?: object, content?: any }>} suggestion child node(s)
+	 */
 	const groupCreateSubGroupSuggestion = async (parentJid, suggestion) => {
 		await groupQuery(parentJid, 'set', [{ tag: 'sub_group_suggestion', attrs: {}, content: suggestion }])
 	}
-	
+	/**
+	 * Approve or reject sub-group suggestions for a community. Ported from WhatsApp
+	 * Web's WASmaxGroupsSubGroupSuggestionsActionRPC. NOTE: untested against live WhatsApp.
+	 * @param {string} parentJid community/parent group to address
+	 * @param {'approve' | 'reject'} action
+	 * @param {Array<{ creator: string, jid?: string }>} suggestions
+	 */
 	const groupSubGroupSuggestionsAction = async (parentJid, action, suggestions) => {
 		await groupQuery(parentJid, 'set', [
 			{
-				tag: 'sub_group_suggestions_action',
+				tag: action,
 				attrs: {},
-				content: [
-					{
-						tag: action,
-						attrs: {},
-						content: suggestions.map(s => ({
-							tag: 'sub_group_suggestion',
-							attrs: action === 'cancel' ? { jid: s.jid } : { creator: s.creator }
-						}))
-					}
-				]
+				content: suggestions.map(s => ({
+					tag: 'sub_group_suggestion',
+					attrs: { creator: s.creator, ...(s.jid ? { jid: s.jid } : {}) }
+				}))
 			}
 		])
 	}
@@ -164,9 +169,8 @@ const makeGroupsSocket = config => {
 				data[meta.id] = meta
 			}
 		}
-		const allGroups = Object.values(data)
-		persistParticipantLidMappings(allGroups.map(g => g.participants)).catch(() => {})
-		sock.ev.emit('groups.update', allGroups)
+		// TODO: properly parse LID / PN DATA
+		sock.ev.emit('groups.update', Object.values(data))
 		return data
 	}
 	sock.ws.on('CB:ib,,dirty', async node => {
@@ -302,14 +306,23 @@ const makeGroupsSocket = config => {
 			const result = (0, WABinary_1.getBinaryNodeChild)(results, 'group')
 			return result?.attrs.jid
 		},
-		
+		/**
+		 * revoke a v4 invite for someone
+		 * @param groupJid group jid
+		 * @param invitedJid jid of person you invited
+		 * @returns true if successful
+		 */
 		groupRevokeInviteV4: async (groupJid, invitedJid) => {
 			const result = await groupQuery(groupJid, 'set', [
 				{ tag: 'revoke', attrs: {}, content: [{ tag: 'participant', attrs: { jid: invitedJid } }] }
 			])
 			return !!result
 		},
-		
+		/**
+		 * accept a GroupInviteMessage
+		 * @param key the key of the invite message, or optionally only provide the jid of the person who sent the invite
+		 * @param inviteMessage the message to accept
+		 */
 		groupAcceptInviteV4: ev.createBufferedFunction(async (key, inviteMessage) => {
 			key = typeof key === 'string' ? { remoteJid: key } : key
 			const results = await groupQuery(inviteMessage.groupJid, 'set', [
@@ -322,10 +335,10 @@ const makeGroupsSocket = config => {
 					}
 				}
 			])
-			
-			
+			// if we have the full message key
+			// update the invite message to be expired
 			if (key.id) {
-				
+				// create new invite message that is expired
 				inviteMessage = index_js_1.proto.Message.GroupInviteMessage.fromObject(inviteMessage)
 				inviteMessage.inviteExpiration = 0
 				inviteMessage.inviteCode = ''
@@ -340,7 +353,7 @@ const makeGroupsSocket = config => {
 					}
 				])
 			}
-			
+			// generate the group add message
 			await upsertMessage(
 				{
 					key: {
@@ -379,7 +392,9 @@ const makeGroupsSocket = config => {
 				{ tag: 'membership_approval_mode', attrs: {}, content: [{ tag: 'group_join', attrs: { state: mode } }] }
 			])
 		},
-		
+		/**
+		 * Get past participants of a group (left/removed members)
+		 */
 		groupGetPastParticipants: async jid => {
 			const result = await groupQuery(jid, 'get', [{ tag: 'past_participants', attrs: {} }])
 			const node = (0, WABinary_1.getBinaryNodeChild)(result, 'past_participants')
@@ -391,22 +406,23 @@ const makeGroupsSocket = config => {
 				leaveTimestamp: p.attrs.t ? Number(p.attrs.t) : undefined
 			}))
 		},
-		
+		/**
+		 * Create a subgroup within a community
+		 */
 		groupCreateSubgroup: async (communityJid, subject, participants = []) => {
 			const key = (0, Utils_1.generateMessageIDV2)()
 			const result = await groupQuery('@g.us', 'set', [
 				{
 					tag: 'create',
-					attrs: { subject, key },
-					content: [
-						...participants.map(jid => ({ tag: 'participant', attrs: { jid } })),
-						{ tag: 'linked_parent', attrs: { jid: communityJid } }
-					]
+					attrs: { subject, key, parent_group_id: communityJid },
+					content: participants.map(jid => ({ tag: 'participant', attrs: { jid } }))
 				}
 			])
 			return (0, exports.extractGroupMetadata)(result)
 		},
-		
+		/**
+		 * Link an existing group to a community
+		 */
 		groupLinkToCommunity: async (communityJid, groupJid) => {
 			await groupQuery(communityJid, 'set', [
 				{
@@ -418,7 +434,9 @@ const makeGroupsSocket = config => {
 				}
 			])
 		},
-		
+		/**
+		 * Unlink a group from a community
+		 */
 		groupUnlinkFromCommunity: async (communityJid, groupJid) => {
 			await groupQuery(communityJid, 'set', [
 				{
@@ -430,7 +448,12 @@ const makeGroupsSocket = config => {
 				}
 			])
 		},
-		
+		/**
+		 * Set a member label/tag in a group
+		 * @param jid group JID
+		 * @param participantJid participant JID to label
+		 * @param label the label string ('' to remove)
+		 */
 		groupSetMemberLabel: async (jid, participantJid, label) => {
 			await groupQuery(jid, 'set', [
 				{
@@ -445,7 +468,9 @@ const makeGroupsSocket = config => {
 				}
 			])
 		},
-		
+		/**
+		 * Get community-linked subgroups for a community JID
+		 */
 		groupGetLinkedSubgroups: async communityJid => {
 			const result = await groupQuery(communityJid, 'get', [{ tag: 'links', attrs: { link_type: 'sub_group' } }])
 			const linksNode = (0, WABinary_1.getBinaryNodeChild)(result, 'links')
@@ -459,20 +484,26 @@ const makeGroupsSocket = config => {
 		},
 		groupFetchAllParticipating,
 
-		
+		// ── MEX queries (JSON responses) ──────────────────────────────────────
 
-		
-		groupQueryInfo: jid => mexQuery({ group_id: jid }, GROUP_MEX_QUERY_IDS.QUERY_INFO, 'xwa2_group_query_by_id'),
+		/**
+		 * Fetch group info via MEX (richer than IQ — includes invite link, LID addressing, etc.)
+		 * @param {string} jid - Group JID
+		 */
+		groupQueryInfo: jid =>
+			mexQuery({ group_id: jid }, GROUP_MEX_QUERY_IDS.QUERY_INFO, 'xwa2_group_query_by_id'),
 
-		
+		/**
+		 * Fetch group info by invite code via MEX.
+		 * @param {string} code - Group invite code (without the link prefix)
+		 */
 		groupQueryInfoByCode: code =>
-			mexQuery(
-				{ group_input: { invite_code: code } },
-				GROUP_MEX_QUERY_IDS.QUERY_INFO_BY_CODE,
-				'xwa2_group_query_by_id'
-			),
+			mexQuery({ group_input: { invite_code: code } }, GROUP_MEX_QUERY_IDS.QUERY_INFO_BY_CODE, 'xwa2_group_query_by_id'),
 
-		
+		/**
+		 * Fetch multiple groups at once via MEX.
+		 * @param {string[]} jids - Array of group JIDs
+		 */
 		groupQueryBatch: jids =>
 			mexQuery(
 				{ groups_input: jids.map(group_id => ({ group_id })) },
@@ -480,15 +511,24 @@ const makeGroupsSocket = config => {
 				'xwa2_group_query_batch'
 			),
 
-		
+		/**
+		 * Fetch invite link info via MEX (includes expiration, creator, etc.)
+		 * @param {string} jid - Group JID
+		 */
 		groupQueryInviteLink: jid =>
 			mexQuery({ group_input: { group_id: jid } }, GROUP_MEX_QUERY_IDS.QUERY_INVITE_LINK, 'xwa2_group_query_by_id'),
 
-		
+		/**
+		 * Fetch all groups the current user is participating in via MEX.
+		 * Returns richer data than the IQ-based groupFetchAllParticipating.
+		 */
 		groupQueryParticipating: () =>
 			mexQuery({}, GROUP_MEX_QUERY_IDS.QUERY_PARTICIPATING, 'xwa2_group_query_participating'),
 
-		
+		/**
+		 * Fetch suggested groups (community sub-group suggestions) via MEX.
+		 * @param {string} communityJid - Community JID to get suggestions for
+		 */
 		groupQuerySuggested: communityJid =>
 			mexQuery(
 				{ group_input: { group_id: communityJid } },
@@ -496,11 +536,17 @@ const makeGroupsSocket = config => {
 				'xwa2_group_query_by_id'
 			),
 
-		
+		/**
+		 * Fetch linked subgroup info for a community group via MEX.
+		 * @param {string} jid - Group or community JID
+		 */
 		groupQueryLinked: jid =>
 			mexQuery({ group_input: { group_id: jid } }, GROUP_MEX_QUERY_IDS.QUERY_LINKED, 'xwa2_group_query_by_id'),
 
-		
+		/**
+		 * Fetch subgroups of a community via MEX.
+		 * @param {string} communityJid - Community JID
+		 */
 		groupQuerySubgroups: communityJid =>
 			mexQuery(
 				{ group_input: { group_id: communityJid } },
@@ -508,7 +554,12 @@ const makeGroupsSocket = config => {
 				'xwa2_group_query_by_id'
 			),
 
-		
+		/**
+		 * Add participants to a group via MEX (V2 — supports LID, privacy metadata).
+		 * Falls back to the IQ-based groupParticipantsUpdate for older servers.
+		 * @param {string} jid - Group JID
+		 * @param {string[]} participants - Array of JIDs to add
+		 */
 		groupAddParticipantsMex: (jid, participants) =>
 			mexQuery(
 				{ group_id: jid, participants: participants.map(p => ({ user_jid: p })) },
@@ -516,15 +567,29 @@ const makeGroupsSocket = config => {
 				'xwa2_group_add_participants'
 			),
 
-		
+		/**
+		 * Set a group property via MEX.
+		 * Known properties: member_add_mode, membership_approval_mode_enabled, member_share_group_history_mode
+		 * @param {string} jid - Group JID
+		 * @param {string} property - Property name
+		 * @param {*} value - Property value
+		 */
 		groupSetProperty: (jid, property, value) =>
-			mexQuery({ group_id: jid, [property]: value }, GROUP_MEX_QUERY_IDS.SET_PROPERTY, 'xwa2_group_update_property'),
+			mexQuery({ group_id: jid, [property]: value }, GROUP_MEX_QUERY_IDS.SET_PROPERTY, 'xwa2_group_set_property'),
 
-		
+		/**
+		 * Reset a group's invite link via MEX (generates new code, invalidates old one).
+		 * @param {string} jid - Group JID
+		 */
 		groupResetInviteLinkMex: jid =>
 			mexQuery({ group_jid: jid }, GROUP_MEX_QUERY_IDS.RESET_INVITE_LINK, 'xwa2_group_reset_invite_link'),
 
-		
+		/**
+		 * Create a group via MEX.
+		 * Confirmed from CreateGroup mutation — input: { subject, participants: [{jid}] }
+		 * @param {string} subject - Group name
+		 * @param {string[]} participantJids
+		 */
 		groupCreateMex: (subject, participantJids) =>
 			mexQuery(
 				{ input: { subject, participants: participantJids.map(jid => ({ jid })) } },
@@ -532,7 +597,11 @@ const makeGroupsSocket = config => {
 				'xwa2_group_create'
 			),
 
-		
+		/**
+		 * Allow non-admin community members to create subgroups.
+		 * @param {string} communityJid - Community JID
+		 * @param {boolean} allow
+		 */
 		groupAllowNonAdminCreation: (communityJid, allow) =>
 			mexQuery(
 				{ group_jid: communityJid, allow_non_admin_sub_group_creation: allow },
@@ -540,19 +609,32 @@ const makeGroupsSocket = config => {
 				'xwa2_group_allow_non_admin_creation'
 			),
 
-		
+		/**
+		 * Get info about a group invite link (before joining).
+		 * @param {string} inviteCode - The raw invite code (not full URL)
+		 */
 		groupGetInviteInfo: inviteCode =>
 			mexQuery({ invite_code: inviteCode }, GROUP_MEX_QUERY_IDS.GET_INVITE_INFO, 'xwa2_group_get_invite_info'),
 
-		
+		/**
+		 * Fetch pending add requests for pre-registration group invites.
+		 * @param {string} jid - Group JID
+		 */
 		groupPreRegAddRequests: jid =>
 			mexQuery({ group_jid: jid }, GROUP_MEX_QUERY_IDS.GET_PRE_REG_ADD_REQUESTS, 'xwa2_group_pre_reg_add_requests'),
 
-		
+		/**
+		 * Get suggested contacts to add to a group.
+		 * @param {string} jid - Group JID
+		 */
 		groupSuggestedContacts: jid =>
 			mexQuery({ group_jid: jid }, GROUP_MEX_QUERY_IDS.GET_SUGGESTED_CONTACTS, 'xwa2_group_suggested_contacts'),
 
-		
+		/**
+		 * Store SMS invite links for a group.
+		 * @param {string} jid - Group JID
+		 * @param {{ phone: string, inviteCode: string }[]} invites
+		 */
 		groupStoreInvitesSms: (jid, invites) =>
 			mexQuery(
 				{ group_jid: jid, invites: invites.map(({ phone, inviteCode }) => ({ phone, invite_code: inviteCode })) },
@@ -560,7 +642,11 @@ const makeGroupsSocket = config => {
 				'xwa2_group_store_invites_sms'
 			),
 
-		
+		/**
+		 * Log a server-sent invite intent (analytics).
+		 * @param {string} jid - Group JID
+		 * @param {string} inviteCode
+		 */
 		groupLogServerSentInvite: (jid, inviteCode) =>
 			mexQuery(
 				{ group_jid: jid, invite_code: inviteCode },
@@ -568,10 +654,17 @@ const makeGroupsSocket = config => {
 				'xwa2_group_log_server_sent_invite'
 			),
 
-		
-		queryOnlineStatus: jids => mexQuery({ jids }, GROUP_MEX_QUERY_IDS.QUERY_ONLINE_STATUS, 'xwa2_query_online_status'),
+		/**
+		 * Query online status of users from PDP.
+		 * @param {string[]} jids - User JIDs
+		 */
+		queryOnlineStatus: jids =>
+			mexQuery({ jids }, GROUP_MEX_QUERY_IDS.QUERY_ONLINE_STATUS, 'xwa2_query_online_status'),
 
-		
+		/**
+		 * Query online status and last seen of users from PDP.
+		 * @param {string[]} jids - User JIDs
+		 */
 		queryOnlineStatusLastSeen: jids =>
 			mexQuery({ jids }, GROUP_MEX_QUERY_IDS.QUERY_ONLINE_STATUS_LAST_SEEN, 'xwa2_query_online_status_last_seen'),
 
@@ -605,11 +698,6 @@ const extractGroupMetadata = result => {
 	const communityMemberAddGroupNode = (0, WABinary_1.getBinaryNodeChild)(group, 'allow_non_admin_sub_group_creation')
 	const subGroupVisibilityNode = (0, WABinary_1.getBinaryNodeChild)(group, 'sub_groups_list')
 	const membershipApprovalNode = (0, WABinary_1.getBinaryNodeChild)(group, 'membership_approval_mode')
-	const capiNode = (0, WABinary_1.getBinaryNodeChild)(group, 'capi')
-	const appealStatusNode = (0, WABinary_1.getBinaryNodeChild)(group, 'appeal_status')
-	const defaultSubGroupNode = (0, WABinary_1.getBinaryNodeChild)(group, 'default_sub_group')
-	const generalChatNode = (0, WABinary_1.getBinaryNodeChild)(group, 'general_chat')
-	const hiddenGroupNode = (0, WABinary_1.getBinaryNodeChild)(group, 'hidden_group')
 	const metadata = {
 		id: groupId,
 		notify: group.attrs.notify,
@@ -639,23 +727,15 @@ const extractGroupMetadata = result => {
 		isCommunityAnnounce: !!(0, WABinary_1.getBinaryNodeChild)(group, 'default_sub_group'),
 		joinApprovalMode: !!membershipApprovalNode,
 		memberAddMode,
-		memberShareHistoryMode:
-			(0, WABinary_1.getBinaryNodeChildString)(group, 'member_share_group_history_mode') || undefined,
-		memberLinkMode: (0, WABinary_1.getBinaryNodeChildString)(group, 'member_link_mode') || undefined,
-		limitSharing: !!(0, WABinary_1.getBinaryNodeChild)(group, 'limit_sharing_enabled'),
-		communityMemberAddGroupMode: communityMemberAddGroupNode?.attrs.state || undefined,
-		capiCreatedGroup: !!capiNode || undefined,
-		appealStatus: appealStatusNode?.attrs.type || undefined,
+		memberShareHistoryMode: (0, WABinary_1.getBinaryNodeChildString)(group, 'member_share_group_history_mode') || undefined,
+			memberLinkMode: (0, WABinary_1.getBinaryNodeChildString)(group, 'member_link_mode') || undefined,
+			limitSharing: !!(0, WABinary_1.getBinaryNodeChild)(group, 'limit_sharing_enabled'),
+			communityMemberAddGroupMode: communityMemberAddGroupNode?.attrs.state || undefined,
+		capiCreatedGroup: group.attrs.capi_created === 'true' || undefined,
+		appealStatus: group.attrs.appeal_status || undefined,
 		isSubGroupHidden: group.attrs.sub_group_visibility === 'hidden' || undefined,
-		membershipApprovalMode: group.attrs.membership_approval_mode || undefined,
-		joinPermissions: group.attrs.join_permissions || undefined,
-		isDefaultSubgroup: !!defaultSubGroupNode || undefined,
-		isGeneralSubgroup: !!generalChatNode || undefined,
-		isHiddenSubgroup: !!hiddenGroupNode || undefined,
 		participants: (0, WABinary_1.getBinaryNodeChildren)(group, 'participant').map(({ attrs }) => {
-			
-			
-			
+			// TODO: Store LID MAPPINGS
 			return {
 				id: attrs.jid,
 				phoneNumber:
@@ -667,12 +747,11 @@ const extractGroupMetadata = result => {
 				admin: attrs.type || null,
 				memberLabel: attrs.label || undefined,
 				memberLabelTimestamp: attrs.label_ts ? +attrs.label_ts : undefined,
-				isBanned: attrs.error === '402' || attrs.ban === 'true' || undefined,
-				uuid: attrs.uuid || attrs.participant_uuid || undefined
+				isBanned: attrs.error === '403' || attrs.ban === 'true' || undefined
 			}
 		}),
 		bannedParticipants: (0, WABinary_1.getBinaryNodeChildren)(group, 'participant')
-			.filter(({ attrs }) => attrs.error === '402' || attrs.ban === 'true')
+			.filter(({ attrs }) => attrs.error === '403' || attrs.ban === 'true')
 			.map(({ attrs }) => ({
 				id: attrs.jid,
 				phoneNumber: attrs.phone_number || undefined,

package/lib/Socket/index.js

@@ -7,10 +7,11 @@ const { makePrivacySocket } = require('./privacy')
 const { makeRegistrationSocket } = require('./registration')
 const { makeManagedAccountSocket } = require('./managed-account')
 const { makeGraphQLSocket } = require('./graphql')
-
+// Antiban protection — bundled directly into this package
 const { wrapSocket: _wrapSocket } = require('../antiban')
+const { attachTextRouter } = require('./text-router')
 
-
+// export the last socket layer
 const makeWASocket = config => {
 	const userExplicitSyncFlag = typeof config?.syncFullHistory === 'boolean'
 	const initialFullSyncDone = !!config?.auth?.creds?.initialFullSyncDone
@@ -30,12 +31,9 @@ const makeWASocket = config => {
 	const registrationSock = makeRegistrationSocket(privacySock)
 	const managedSock = makeManagedAccountSocket(registrationSock)
 	const sock = makeGraphQLSocket(managedSock)
-
-	
-	if (_wrapSocket && config?.antiban !== false) {
-		const antibanConfig = config?.antiban || 'aggressive'
-		return _wrapSocket(sock, antibanConfig)
-	}
-	return sock
+	// Auto-wrap with antiban if available (config.antiban = false to opt-out)
+	const finalSock =
+		_wrapSocket && config?.antiban !== false ? _wrapSocket(sock, config?.antiban || 'aggressive') : sock
+	return attachTextRouter(finalSock)
 }
 exports.default = makeWASocket