@badzz88/baileys 8.5.4 → 8.5.5

package/lib/Socket/graphql.js

@@ -1,30 +1,32 @@
 'use strict'
 Object.defineProperty(exports, '__esModule', { value: true })
-exports.makeGraphQLSocket =
-	exports.executeWWWGraphQL =
-	exports.executeWamoGraphQL =
-	exports.executeFacebookGraphQL =
-		void 0
+exports.makeGraphQLSocket = exports.executeWWWGraphQL = exports.executeWamoGraphQL = exports.executeFacebookGraphQL = void 0
 
 const boom_1 = require('@hapi/boom')
 
-
+// Endpoints confirmed from APX.java and WamoGraphQLExecutor.java
 const ENDPOINTS = {
 	WWW: 'https://graph.whatsapp.com/graphql',
 	ACS: 'https://acs.whatsapp.com/graphql',
-	
-	
-	
+	// Wamo host is fetched dynamically at runtime from a config service.
+	// The path /api/wamo/graphql/ is appended to this base host.
+	// Callers must provide the full wamo URL or use a configured host.
 	WAMO_PATH: '/api/wamo/graphql/'
 }
 
-
-
-
+// Default fallback token — only valid as a no-op / anonymous placeholder.
+// Real sessions must supply a token obtained via wwwGetNonce + wwwExchangeNonce.
+// Confirmed from APX.java: "WA|1015890928915437|3201f239340c1c8ec6262a6dad04200e"
 const WAMO_APP_ID = '1015890928915437'
 const WWW_DEFAULT_TOKEN = `WA|${WAMO_APP_ID}|3201f239340c1c8ec6262a6dad04200e`
 
-
+/**
+ * Parse a GraphQL JSON response and extract the data at the given path.
+ * Throws a Boom error if errors are present or the path is missing.
+ *
+ * @param {object} json - Parsed JSON response body
+ * @param {string|null} dataPath - Key in data to extract (null = full data)
+ */
 const parseGraphQLResponse = (json, dataPath) => {
 	if (json.errors?.length) {
 		const msgs = json.errors.map(e => e.message || 'Unknown error').join(', ')
@@ -32,21 +34,28 @@ const parseGraphQLResponse = (json, dataPath) => {
 		throw new boom_1.Boom(`GraphQL error: ${msgs}`, { statusCode: code, data: json.errors[0] })
 	}
 	const response = dataPath ? json?.data?.[dataPath] : json?.data
-	if (response === undefined) {
+	if (typeof response === 'undefined') {
 		throw new boom_1.Boom('Unexpected GraphQL response structure', { statusCode: 400, data: json })
 	}
 	return response
 }
 
-
-const executeWWWGraphQL = async (
-	docId,
-	variables,
-	accessToken,
-	dataPath = null,
-	lang = 'en',
-	endpoint = ENDPOINTS.WWW
-) => {
+/**
+ * Execute a www-schema GraphQL query over HTTPS.
+ *
+ * Transport confirmed from APX.java:
+ *   POST https://graph.whatsapp.com/graphql
+ *   Content-Type: application/json
+ *   Body: { access_token, doc_id, variables, lang }
+ *
+ * @param {string|number} docId - Numeric doc_id from whatsapp-android-www asset file
+ * @param {object} variables - Query variables
+ * @param {string} [accessToken] - ACS access token (obtain via wwwGetNonce + wwwExchangeNonce)
+ * @param {string|null} [dataPath] - JSON data key to extract from response
+ * @param {string} [lang='en'] - Language for response
+ * @param {string} [endpoint] - Override endpoint URL (default: graph.whatsapp.com/graphql)
+ */
+const executeWWWGraphQL = async (docId, variables, accessToken, dataPath = null, lang = 'en', endpoint = ENDPOINTS.WWW) => {
 	const token = accessToken || WWW_DEFAULT_TOKEN
 	const body = JSON.stringify({ access_token: token, doc_id: String(docId), variables, lang })
 	const res = await fetch(endpoint, {
@@ -63,13 +72,39 @@ const executeWWWGraphQL = async (
 
 exports.executeWWWGraphQL = executeWWWGraphQL
 
-
+/**
+ * Execute a facebook-schema GraphQL query over HTTPS.
+ *
+ * Transport confirmed from WaFaConfigFetcher.java:
+ *   POST https://acs.whatsapp.com/graphql
+ *   Content-Type: application/json
+ *   Body: { access_token, doc_id, variables, lang }
+ *
+ * @param {string|number} docId - Numeric doc_id from whatsapp-android-facebook-schema asset file
+ * @param {object} variables - Query variables
+ * @param {string} [accessToken] - ACS access token
+ * @param {string|null} [dataPath] - JSON data key to extract
+ * @param {string} [lang='en']
+ */
 const executeFacebookGraphQL = (docId, variables, accessToken, dataPath = null, lang = 'en') =>
 	executeWWWGraphQL(docId, variables, accessToken, dataPath, lang, ENDPOINTS.ACS)
 
 exports.executeFacebookGraphQL = executeFacebookGraphQL
 
-
+/**
+ * Execute a wamo-schema GraphQL query over HTTPS.
+ *
+ * Transport confirmed from WamoGraphQLExecutor.java:
+ *   POST https://<wamoHost>/api/wamo/graphql/
+ *   Content-Type: application/x-www-form-urlencoded
+ *   Body: access_token=<token>&credential=<cred>&user_id=<uid>&app_id=1015890928915437&doc_id=<id>&variables=<json>
+ *
+ * @param {string|number} docId - Numeric doc_id from whatsapp-android-wamo asset file
+ * @param {object} variables - Query variables
+ * @param {object} wamoAuth - { accessToken, credential, userId }
+ * @param {string|null} [dataPath] - JSON data key to extract
+ * @param {string} [wamoHost='wamo.whatsapp.net'] - Wamo API host (fetched from config at runtime)
+ */
 const executeWamoGraphQL = async (docId, variables, wamoAuth = {}, dataPath = null, wamoHost = 'wamo.whatsapp.net') => {
 	const { accessToken = WWW_DEFAULT_TOKEN, credential = '', userId = '' } = wamoAuth
 	const params = new URLSearchParams({
@@ -95,42 +130,42 @@ const executeWamoGraphQL = async (docId, variables, wamoAuth = {}, dataPath = nu
 
 exports.executeWamoGraphQL = executeWamoGraphQL
 
-
+// ── Wamo schema IDs (whatsapp-android-wamo_client_persist_ids.json) ──────────
 const WAMO_GQL_IDS = {
-	BLOKS_GET_LAYOUT: '35761428053502960', 
-	CREATE_USER: '26643102025382056', 
-	DELETE_USER: '26847597944871230', 
-	DYI_JOB_CREATE: '35432158949761170', 
-	DYI_JOB_DELETE: '35418212507825480', 
-	DYI_JOB_STATUS: '26233222629644330', 
-	HEARTBEAT: '26147852544878404', 
-	HIDE_PAGE: '26762670266664464', 
-	HIDE_PROMO: '26672924455626300', 
-	LINK_USER: '26986545907702584', 
-	REPORT_PROMO: '26170110515981668', 
-	START_VIEWER_SESSION: '25895257976843090', 
-	UNHIDE_PAGE: '26357347627241176', 
-	UNHIDE_PAGE_V2: '26343585518664600', 
-	USER_BASIC: '26217108451265492' 
+	BLOKS_GET_LAYOUT: '35761428053502960', // WamoBloksGetLayoutQuery
+	CREATE_USER: '26643102025382056', // WamoCreateUserMutation
+	DELETE_USER: '26847597944871230', // WamoDeleteUserMutation
+	DYI_JOB_CREATE: '35432158949761170', // WamoDYIJobCreateMutation
+	DYI_JOB_DELETE: '35418212507825480', // WamoDYIJobDeleteMutation
+	DYI_JOB_STATUS: '26233222629644330', // WamoDYIJobStatusQuery
+	HEARTBEAT: '26147852544878404', // WamoHeartbeatMutation
+	HIDE_PAGE: '26762670266664464', // WamoHidePageMutation
+	HIDE_PROMO: '26672924455626300', // WamoHidePromoMutation
+	LINK_USER: '26986545907702584', // WamoLinkUserMutation
+	REPORT_PROMO: '26170110515981668', // WamoReportPromoMutation
+	START_VIEWER_SESSION: '25895257976843090', // WamoStartViewerSessionQuery
+	UNHIDE_PAGE: '26357347627241176', // WamoUnhidePageMutation
+	UNHIDE_PAGE_V2: '26343585518664600', // WamoUnhidePageV2Mutation
+	USER_BASIC: '26217108451265492' // WamoUserBasicQuery
 }
 
-
+// ── Facebook schema IDs (whatsapp-android-facebook-schema_client_persist_ids.json) ──
 const FACEBOOK_GQL_IDS = {
-	ACDC_CREATE_COMMERCE_NONCE: '24264828513176160', 
-	BIZ_ALERTS_NOTIFICATION_LIST: '25131061249916280', 
-	BIZ_ALERTS_UPDATE: '31887288120915504', 
-	CTWA_ADS_CONTEXT_BIZ: '26795336300063576', 
-	DIGITAL_CONTENT_IAP_PURCHASE_QUOTE: '24407486212227380', 
-	GET_COMPLIANCE: '25758882000383880', 
-	GET_CUSTOM_URLS: '24381430531538260', 
-	GET_DCP_PRODUCTS: '24562080436794784', 
-	SET_COMPLIANCE: '25904531552477560', 
-	USERNAME_RECOMMENDATIONS: '24622018447392760' 
+	ACDC_CREATE_COMMERCE_NONCE: '24264828513176160', // AcDcCreateDigitalCommerceNonse
+	BIZ_ALERTS_NOTIFICATION_LIST: '25131061249916280', // BizAlertsNotificationList
+	BIZ_ALERTS_UPDATE: '31887288120915504', // BizAlertsUpdateMutation
+	CTWA_ADS_CONTEXT_BIZ: '26795336300063576', // CtwaAdsContextBizQuery
+	DIGITAL_CONTENT_IAP_PURCHASE_QUOTE: '24407486212227380', // DigitalContentIAPPurchaseQuoteMutation
+	GET_COMPLIANCE: '25758882000383880', // GetCompliance
+	GET_CUSTOM_URLS: '24381430531538260', // GetCustomUrlsQuery
+	GET_DCP_PRODUCTS: '24562080436794784', // GetDcpProductsQuery
+	SET_COMPLIANCE: '25904531552477560', // SetCompliance
+	USERNAME_RECOMMENDATIONS: '24622018447392760' // UsernameRecommendationsQuery
 }
 
-
+// ── WWW schema IDs (whatsapp-android-www_client_persist_ids.json) ─────────────
 const WWW_GQL_IDS = {
-	
+	// Meta AI
 	AI_IMAGINE_EDIT_VIDEO_STYLES: '27077837108487436',
 	AI_STUDIO_MEMORY_DELETE_ALL: '30717961127818650',
 	AI_STUDIO_MEMORY_DELETE: '9705428856224794',
@@ -157,7 +192,7 @@ const WWW_GQL_IDS = {
 	META_AI_COMMAND_GET: '26391941983796720',
 	META_CONFIG_FETCH: '26061411083512356',
 	META_POI_TYPE_AHEAD: '24998731673114764',
-	
+	// Imagine / GenAI
 	IMAGINE_CANVAS_CONTENT: '25210964258554530',
 	IMAGINE_EDIT: '26387089294279400',
 	IMAGINE_EDIT_VIDEO: '34646600944984156',
@@ -174,12 +209,12 @@ const WWW_GQL_IDS = {
 	IMMERSIVE_CREATION_COMPLETE: '25751460157775136',
 	IMMERSIVE_CREATION_CONFIG: '32047877418194044',
 	GEN_AI_IMAGINE_3P_FOR_INTENTS: '26873302172253410',
-	
+	// Avatar
 	AVATAR_USER_RECOVERY: '24876192928715390',
 	LOAD_AVATAR_POSES: '25262916630008930',
 	SAVE_AVATAR_POSE: '24194307116878704',
 	SELECTED_OR_DEFAULT_POSE: '24956844700642720',
-	
+	// Events
 	ADD_EVENT_INVITATIONS: '26095825686706664',
 	CREATE_EVENT: '27259582783645464',
 	DELETE_EVENT: '24671535952543812',
@@ -193,7 +228,7 @@ const WWW_GQL_IDS = {
 	ROTATE_EVENT_INVITE_LINK: '27134834146102810',
 	UPDATE_EVENT: '35415093074772810',
 	UPDATE_EVENT_RSVP: '25954023907630800',
-	
+	// Payments (Brazil PIX)
 	BR_AUTHORIZE_BIOMETRIC_PAYMENT: '26860182267017040',
 	BR_COMPLETE_ENROLLMENT_REGISTRATION: '34346544594993864',
 	BR_GET_AUTH_OPTIONS: '26954282557514064',
@@ -221,7 +256,7 @@ const WWW_GQL_IDS = {
 	PAY_WITH_PIX_PRECHECK: '25489011890740690',
 	SAVE_REMITTANCE_PAYMENT_MESSAGE_ID: '26662893096684910',
 	SAVE_SENDER_PAYMENT_MESSAGE_PREFERENCE: '35084492951197548',
-	
+	// Payments (UPI India)
 	GET_UPI_ACCOUNTS: '25691302307224710',
 	GET_UPI_LITE_DETAILS: '25808397275476136',
 	GET_UPI_PURPOSE_LIMITING_KEY: '25956012240759790',
@@ -234,10 +269,10 @@ const WWW_GQL_IDS = {
 	UPI_RESUME_MANDATE: '26691956223780310',
 	UPI_REVOKE_MANDATE: '25917438317930590',
 	ENROLL_AND_GET_INCENTIVE_REFERRAL_ID: '26794756530116496',
-	
+	// Payments (PMTA)
 	PMTA_GET_AI_CONTROLS: '35629699809954692',
 	PMTA_SET_AI_CONTROLS: '35241761128770990',
-	
+	// Wamo (commerce, via www schema)
 	WAMO_AFS_SUBSCRIPTION_INFO: '26173991525527520',
 	WAMO_PROMO_ID_DELETE: '35985621974354824',
 	WAMO_PROMO_ID_QUERY: '35176707691976468',
@@ -245,7 +280,7 @@ const WWW_GQL_IDS = {
 	WAMO_SUB_CANCEL_SUBSCRIPTION: '24229142763394572',
 	WAMO_SUB_OVERRIDE_STATUS: '24524888373876350',
 	WAMO_SUB_QUERY_STATUS: '25015488928115160',
-	
+	// Business / Catalog
 	BRAND_IDS_GET_PHONE_NUMBERS: '33159498536982770',
 	BUSINESS_INTERACTION_PILLS: '26641674408836110',
 	GET_BUSINESS_PROFILE_WEBSITE_SHIM_URL: '32216187747994820',
@@ -254,7 +289,7 @@ const WWW_GQL_IDS = {
 	WA_WEB_BIZ_QUERY_ORDER_JOB: '26400495852915744',
 	WHATSAPP_CATALOG_REPORT_PRODUCT: '31943750621890740',
 	EXTERNAL_CTX_AUTHORISE_WA_CHAT: '31162432756736010',
-	
+	// User / account
 	FACEBOOK_ACCOUNT_NAME: '25250471057951830',
 	INSTAGRAM_ACCOUNT_NAME: '25214758521544980',
 	GET_SIGNUP_METADATA: '26051411631187570',
@@ -267,7 +302,7 @@ const WWW_GQL_IDS = {
 	CANONICAL_ENT_TEARDOWN_FEATURE: '30858669277110520',
 	WWW_CANONICAL_USER_VALID: '25129145013440740',
 	WAFFLE_USER_AGE_CHECK: '26764575806469450',
-	
+	// Support / misc
 	BOT_PROACTIVE_MSG_CONTROL_STATUS: '24651002484600324',
 	BOT_PROACTIVE_MSG_CONTROL_UPDATE: '24122315620764244',
 	BOT_PROFILES_SYNC: '25828046330205656',
@@ -295,7 +330,7 @@ const WWW_GQL_IDS = {
 	FETCH_META_AI_MODES: '26061411083512356'
 }
 
-
+// ── client-persist IDs (whatsapp-android_client-persist.json) ─────────────────
 const CLIENT_PERSIST_GQL_IDS = {
 	ADD_MEMU_PROFILE_PHOTOS: '24668200096214476',
 	CREATE_MEMU_PROFILE: '26069800429275530',
@@ -363,7 +398,13 @@ const makeGraphQLSocket = sock => {
 		if (host) _wamoHost = host
 	}
 
-	
+	/**
+	 * Ensure a valid ACS access token is available.
+	 * On first call (or after invalidation), runs the MEX nonce flow:
+	 *   wwwGetNonce() → wwwExchangeNonce(nonce) → caches the resulting token.
+	 * Subsequent calls return the cached token immediately.
+	 * Concurrent callers share a single in-flight request.
+	 */
 	const acquireAccessToken = () => {
 		if (_accessToken) return Promise.resolve(_accessToken)
 		if (_tokenPromise) return _tokenPromise
@@ -395,339 +436,198 @@ const makeGraphQLSocket = sock => {
 	return {
 		...sock,
 
-		
+		// ── Token management ──────────────────────────────────────────────────
 		setAccessToken,
 		setWamoAuth,
 		acquireAccessToken,
 
-		
+		// ── Raw GraphQL executors ─────────────────────────────────────────────
 		executeWWWGraphQL,
 		executeFacebookGraphQL,
 		executeWamoGraphQL,
 
-		
+		// ── Meta AI ───────────────────────────────────────────────────────────
 		aiStudioMemoryQuery: () => www(WWW_GQL_IDS.AI_STUDIO_MEMORY_QUERY, {}, 'xwa2_ai_studio_wa_memory_query'),
 		aiStudioMemoryDelete: id => www(WWW_GQL_IDS.AI_STUDIO_MEMORY_DELETE, { id }, 'xwa2_ai_studio_wa_memory_delete'),
-		aiStudioMemoryDeleteAll: () =>
-			www(WWW_GQL_IDS.AI_STUDIO_MEMORY_DELETE_ALL, {}, 'xwa2_ai_studio_wa_memory_delete_all'),
+		aiStudioMemoryDeleteAll: () => www(WWW_GQL_IDS.AI_STUDIO_MEMORY_DELETE_ALL, {}, 'xwa2_ai_studio_wa_memory_delete_all'),
 		metaAiMemoryQuery: () => www(WWW_GQL_IDS.META_AI_MEMORY_QUERY, {}, 'xwa2_meta_ai_memory'),
 		metaAiUnifiedMemoryQuery: () => www(WWW_GQL_IDS.META_AI_UNIFIED_MEMORY_QUERY, {}, 'xwa2_meta_ai_unified_memory'),
 		metaAiMemoryDelete: id => www(WWW_GQL_IDS.META_AI_MEMORY_DELETE, { id }, 'xwa2_meta_ai_memory_delete'),
 		metaAiMemoryDeleteAll: () => www(WWW_GQL_IDS.META_AI_MEMORY_DELETE_ALL, {}, 'xwa2_meta_ai_memory_delete_all'),
-		metaAiMemoryOptOutStatus: () =>
-			www(WWW_GQL_IDS.META_AI_MEMORY_OPT_OUT_STATUS, {}, 'xwa2_meta_ai_wa_memory_opt_out_status'),
-		metaAiMemoryOptOutUpdate: optOut =>
-			www(WWW_GQL_IDS.META_AI_MEMORY_OPT_OUT_UPDATE, { opt_out: optOut }, 'xwa2_meta_ai_wa_memory_opt_out_update'),
-		metaAiCommandGet: (chatJid, command) =>
-			www(WWW_GQL_IDS.META_AI_COMMAND_GET, { chat_jid: chatJid, command }, 'xwa2_meta_ai_command_get'),
-		metaAiVoiceOptionsFetch: () =>
-			www(WWW_GQL_IDS.META_AI_VOICE_OPTIONS_FETCH, {}, 'xwa2_meta_ai_voice_wa_options_fetch'),
-		metaAiVoiceOptionsWithDefaultFetch: () =>
-			www(WWW_GQL_IDS.META_AI_VOICE_OPTIONS_WITH_DEFAULT_FETCH, {}, 'xwa2_meta_ai_voice_wa_options_with_default_fetch'),
+		metaAiMemoryOptOutStatus: () => www(WWW_GQL_IDS.META_AI_MEMORY_OPT_OUT_STATUS, {}, 'xwa2_meta_ai_wa_memory_opt_out_status'),
+		metaAiMemoryOptOutUpdate: optOut => www(WWW_GQL_IDS.META_AI_MEMORY_OPT_OUT_UPDATE, { opt_out: optOut }, 'xwa2_meta_ai_wa_memory_opt_out_update'),
+		metaAiCommandGet: (chatJid, command) => www(WWW_GQL_IDS.META_AI_COMMAND_GET, { chat_jid: chatJid, command }, 'xwa2_meta_ai_command_get'),
+		metaAiVoiceOptionsFetch: () => www(WWW_GQL_IDS.META_AI_VOICE_OPTIONS_FETCH, {}, 'xwa2_meta_ai_voice_wa_options_fetch'),
+		metaAiVoiceOptionsWithDefaultFetch: () => www(WWW_GQL_IDS.META_AI_VOICE_OPTIONS_WITH_DEFAULT_FETCH, {}, 'xwa2_meta_ai_voice_wa_options_with_default_fetch'),
 		aiSubscriptionState: () => www(WWW_GQL_IDS.AI_SUBSCRIPTION_STATE, {}, 'xwa2_ai_subscription_state'),
 		aiSubscriptionUsageData: () => www(WWW_GQL_IDS.AI_SUBSCRIPTION_USAGE_DATA, {}, 'xwa2_ai_subscription_usage_data'),
 
-		
+		// ── Imagine / GenAI (www) ─────────────────────────────────────────────
 		imagineEdit: (imageId, prompt) => www(WWW_GQL_IDS.IMAGINE_EDIT, { image_id: imageId, prompt }, 'xwa2_imagine_edit'),
-		imagineEditVideo: (videoId, styleId) =>
-			www(WWW_GQL_IDS.IMAGINE_EDIT_VIDEO, { video_id: videoId, style_id: styleId }, 'xwa2_imagine_edit_video'),
-		imagineExpand: (imageId, direction) =>
-			www(WWW_GQL_IDS.IMAGINE_EXPAND, { image_id: imageId, direction }, 'xwa2_imagine_expand'),
-		imagineGenerateAnimate: (imageId, options = {}) =>
-			www(WWW_GQL_IDS.IMAGINE_GENERATE_ANIMATE, { image_id: imageId, ...options }, 'xwa2_imagine_generate_animate'),
+		imagineEditVideo: (videoId, styleId) => www(WWW_GQL_IDS.IMAGINE_EDIT_VIDEO, { video_id: videoId, style_id: styleId }, 'xwa2_imagine_edit_video'),
+		imagineExpand: (imageId, direction) => www(WWW_GQL_IDS.IMAGINE_EXPAND, { image_id: imageId, direction }, 'xwa2_imagine_expand'),
+		imagineGenerateAnimate: (imageId, options = {}) => www(WWW_GQL_IDS.IMAGINE_GENERATE_ANIMATE, { image_id: imageId, ...options }, 'xwa2_imagine_generate_animate'),
 		imagineIntents: prompt => www(WWW_GQL_IDS.IMAGINE_INTENTS, { prompt }, 'xwa2_imagine_intents'),
-		imagineCanvasContent: canvasId =>
-			www(WWW_GQL_IDS.IMAGINE_CANVAS_CONTENT, { canvas_id: canvasId }, 'xwa2_imagine_canvas_content'),
-		imagineSpotlight: (prompt, options = {}) =>
-			www(WWW_GQL_IDS.IMAGINE_SPOTLIGHT, { prompt, ...options }, 'xwa2_imagine_spotlight'),
+		imagineCanvasContent: canvasId => www(WWW_GQL_IDS.IMAGINE_CANVAS_CONTENT, { canvas_id: canvasId }, 'xwa2_imagine_canvas_content'),
+		imagineSpotlight: (prompt, options = {}) => www(WWW_GQL_IDS.IMAGINE_SPOTLIGHT, { prompt, ...options }, 'xwa2_imagine_spotlight'),
 		imagineVideoStatus: jobId => www(WWW_GQL_IDS.IMAGINE_VIDEO_STATUS, { job_id: jobId }, 'xwa2_imagine_video_status'),
-		imagineReport: (imageId, reason) =>
-			www(WWW_GQL_IDS.IMAGINE_REPORT, { image_id: imageId, reason }, 'xwa2_imagine_report'),
+		imagineReport: (imageId, reason) => www(WWW_GQL_IDS.IMAGINE_REPORT, { image_id: imageId, reason }, 'xwa2_imagine_report'),
 		imagineMeIsOnboarded: () => www(WWW_GQL_IDS.IMAGINE_ME_IS_ONBOARDED, {}, 'xwa2_imagine_me_is_onboarded'),
 		imagineMeOnboarding: input => www(WWW_GQL_IDS.IMAGINE_ME_ONBOARDING, { input }, 'xwa2_imagine_me_onboarding'),
-		imagineMeOnboardingWithValidation: input =>
-			www(WWW_GQL_IDS.IMAGINE_ME_ONBOARDING_WITH_VALIDATION, { input }, 'xwa2_imagine_me_onboarding_with_validation'),
-		imagineMeDeleteOnboarding: () =>
-			www(WWW_GQL_IDS.IMAGINE_ME_DELETE_ONBOARDING, {}, 'xwa2_imagine_me_delete_onboarding'),
-		imagineEditVideoStyles: () =>
-			www(WWW_GQL_IDS.AI_IMAGINE_EDIT_VIDEO_STYLES, {}, 'xwa2_ai_imagine_edit_video_styles'),
-
-		
-		aiCreationFetchCreatedBot: botId =>
-			www(WWW_GQL_IDS.AI_CREATION_FETCH_CREATED_BOT, { bot_id: botId }, 'xwa2_ai_creation_fetch_created_bot'),
-		aiCreationUpdatePersona: (botId, updates) =>
-			www(WWW_GQL_IDS.AI_CREATION_UPDATE_PERSONA, { bot_id: botId, ...updates }, 'xwa2_ai_creation_update_persona'),
-		aiCreationDeletePersona: botId =>
-			www(WWW_GQL_IDS.AI_CREATION_DELETE_PERSONA, { bot_id: botId }, 'xwa2_ai_creation_delete_persona'),
-		aiCreationUploadImage: imageData =>
-			www(WWW_GQL_IDS.AI_CREATION_UPLOAD_IMAGE, { image_data: imageData }, 'xwa2_ai_creation_upload_image'),
-		aiCreationCheckCreatedByMe: botId =>
-			www(WWW_GQL_IDS.AI_CREATION_CHECK_CREATED_BY_ME, { bot_id: botId }, 'xwa2_ai_creation_check_created_by_me'),
-		aiCreationFetchVoiceSample: voiceId =>
-			www(WWW_GQL_IDS.AI_CREATION_FETCH_VOICE_SAMPLE, { voice_id: voiceId }, 'xwa2_ai_creation_fetch_voice_sample'),
-		aiHomeFetchUserCreatedPersonas: () =>
-			www(WWW_GQL_IDS.AI_HOME_FETCH_USER_CREATED_PERSONAS, {}, 'xwa2_ai_home_fetch_user_created_personas'),
+		imagineMeOnboardingWithValidation: input => www(WWW_GQL_IDS.IMAGINE_ME_ONBOARDING_WITH_VALIDATION, { input }, 'xwa2_imagine_me_onboarding_with_validation'),
+		imagineMeDeleteOnboarding: () => www(WWW_GQL_IDS.IMAGINE_ME_DELETE_ONBOARDING, {}, 'xwa2_imagine_me_delete_onboarding'),
+		imagineEditVideoStyles: () => www(WWW_GQL_IDS.AI_IMAGINE_EDIT_VIDEO_STYLES, {}, 'xwa2_ai_imagine_edit_video_styles'),
+
+		// ── AI Creation (bot personas) ─────────────────────────────────────────
+		aiCreationFetchCreatedBot: botId => www(WWW_GQL_IDS.AI_CREATION_FETCH_CREATED_BOT, { bot_id: botId }, 'xwa2_ai_creation_fetch_created_bot'),
+		aiCreationUpdatePersona: (botId, updates) => www(WWW_GQL_IDS.AI_CREATION_UPDATE_PERSONA, { bot_id: botId, ...updates }, 'xwa2_ai_creation_update_persona'),
+		aiCreationDeletePersona: botId => www(WWW_GQL_IDS.AI_CREATION_DELETE_PERSONA, { bot_id: botId }, 'xwa2_ai_creation_delete_persona'),
+		aiCreationUploadImage: imageData => www(WWW_GQL_IDS.AI_CREATION_UPLOAD_IMAGE, { image_data: imageData }, 'xwa2_ai_creation_upload_image'),
+		aiCreationCheckCreatedByMe: botId => www(WWW_GQL_IDS.AI_CREATION_CHECK_CREATED_BY_ME, { bot_id: botId }, 'xwa2_ai_creation_check_created_by_me'),
+		aiCreationFetchVoiceSample: voiceId => www(WWW_GQL_IDS.AI_CREATION_FETCH_VOICE_SAMPLE, { voice_id: voiceId }, 'xwa2_ai_creation_fetch_voice_sample'),
+		aiHomeFetchUserCreatedPersonas: () => www(WWW_GQL_IDS.AI_HOME_FETCH_USER_CREATED_PERSONAS, {}, 'xwa2_ai_home_fetch_user_created_personas'),
 		aiHomeSearch: query => www(WWW_GQL_IDS.AI_HOME_SEARCH, { query }, 'xwa2_ai_home_search'),
-		aiCharacterUpdateHideStatus: (botId, hidden) =>
-			www(
-				WWW_GQL_IDS.AI_CHARACTER_UPDATE_HIDE_STATUS,
-				{ bot_id: botId, hidden },
-				'xwa2_ai_character_update_hide_status'
-			),
-		botProactiveMessageControlStatus: botId =>
-			www(WWW_GQL_IDS.BOT_PROACTIVE_MSG_CONTROL_STATUS, { bot_id: botId }, 'xwa2_bot_proactive_message_control_status'),
-		botProactiveMessageControlUpdate: (botId, enabled) =>
-			www(
-				WWW_GQL_IDS.BOT_PROACTIVE_MSG_CONTROL_UPDATE,
-				{ bot_id: botId, enabled },
-				'xwa2_bot_proactive_message_control_update'
-			),
+		aiCharacterUpdateHideStatus: (botId, hidden) => www(WWW_GQL_IDS.AI_CHARACTER_UPDATE_HIDE_STATUS, { bot_id: botId, hidden }, 'xwa2_ai_character_update_hide_status'),
+		botProactiveMessageControlStatus: botId => www(WWW_GQL_IDS.BOT_PROACTIVE_MSG_CONTROL_STATUS, { bot_id: botId }, 'xwa2_bot_proactive_message_control_status'),
+		botProactiveMessageControlUpdate: (botId, enabled) => www(WWW_GQL_IDS.BOT_PROACTIVE_MSG_CONTROL_UPDATE, { bot_id: botId, enabled }, 'xwa2_bot_proactive_message_control_update'),
 		botProfilesSync: () => www(WWW_GQL_IDS.BOT_PROFILES_SYNC, {}, 'xwa2_bot_profiles_sync'),
 
-		
+		// ── Avatar ────────────────────────────────────────────────────────────
 		avatarUserRecovery: () => www(WWW_GQL_IDS.AVATAR_USER_RECOVERY, {}, 'xwa2_avatar_user_recovery'),
 		loadAvatarPoses: () => www(WWW_GQL_IDS.LOAD_AVATAR_POSES, {}, 'xwa2_load_avatar_poses'),
-		saveAvatarPose: (poseId, options = {}) =>
-			www(WWW_GQL_IDS.SAVE_AVATAR_POSE, { pose_id: poseId, ...options }, 'xwa2_save_avatar_pose'),
+		saveAvatarPose: (poseId, options = {}) => www(WWW_GQL_IDS.SAVE_AVATAR_POSE, { pose_id: poseId, ...options }, 'xwa2_save_avatar_pose'),
 		selectedOrDefaultPose: () => www(WWW_GQL_IDS.SELECTED_OR_DEFAULT_POSE, {}, 'xwa2_selected_or_default_pose'),
 
-		
+		// ── Events ────────────────────────────────────────────────────────────
 		createEvent: input => www(WWW_GQL_IDS.CREATE_EVENT, { input }, 'xwa2_create_event'),
 		getEvent: eventId => www(WWW_GQL_IDS.GET_EVENT, { event_id: eventId }, 'xwa2_get_event'),
-		updateEvent: (eventId, updates) =>
-			www(WWW_GQL_IDS.UPDATE_EVENT, { event_id: eventId, ...updates }, 'xwa2_update_event'),
+		updateEvent: (eventId, updates) => www(WWW_GQL_IDS.UPDATE_EVENT, { event_id: eventId, ...updates }, 'xwa2_update_event'),
 		deleteEvent: eventId => www(WWW_GQL_IDS.DELETE_EVENT, { event_id: eventId }, 'xwa2_delete_event'),
 		listEvents: (options = {}) => www(WWW_GQL_IDS.LIST_EVENTS, options, 'xwa2_list_events'),
-		updateEventRsvp: (eventId, rsvp) =>
-			www(WWW_GQL_IDS.UPDATE_EVENT_RSVP, { event_id: eventId, rsvp }, 'xwa2_update_event_rsvp'),
-		addEventInvitations: (eventId, jids) =>
-			www(WWW_GQL_IDS.ADD_EVENT_INVITATIONS, { event_id: eventId, jids }, 'xwa2_add_event_invitations'),
-		removeEventInvitations: (eventId, jids) =>
-			www(WWW_GQL_IDS.REMOVE_EVENT_INVITATIONS, { event_id: eventId, jids }, 'xwa2_remove_event_invitations'),
-		removeSelfEventInvitation: eventId =>
-			www(WWW_GQL_IDS.REMOVE_SELF_EVENT_INVITATION, { event_id: eventId }, 'xwa2_remove_self_event_invitation'),
-		getOrCreateEventInviteLink: eventId =>
-			www(WWW_GQL_IDS.GET_OR_CREATE_EVENT_INVITE_LINK, { event_id: eventId }, 'xwa2_get_or_create_event_invite_link'),
-		rotateEventInviteLink: eventId =>
-			www(WWW_GQL_IDS.ROTATE_EVENT_INVITE_LINK, { event_id: eventId }, 'xwa2_rotate_event_invite_link'),
+		updateEventRsvp: (eventId, rsvp) => www(WWW_GQL_IDS.UPDATE_EVENT_RSVP, { event_id: eventId, rsvp }, 'xwa2_update_event_rsvp'),
+		addEventInvitations: (eventId, jids) => www(WWW_GQL_IDS.ADD_EVENT_INVITATIONS, { event_id: eventId, jids }, 'xwa2_add_event_invitations'),
+		removeEventInvitations: (eventId, jids) => www(WWW_GQL_IDS.REMOVE_EVENT_INVITATIONS, { event_id: eventId, jids }, 'xwa2_remove_event_invitations'),
+		removeSelfEventInvitation: eventId => www(WWW_GQL_IDS.REMOVE_SELF_EVENT_INVITATION, { event_id: eventId }, 'xwa2_remove_self_event_invitation'),
+		getOrCreateEventInviteLink: eventId => www(WWW_GQL_IDS.GET_OR_CREATE_EVENT_INVITE_LINK, { event_id: eventId }, 'xwa2_get_or_create_event_invite_link'),
+		rotateEventInviteLink: eventId => www(WWW_GQL_IDS.ROTATE_EVENT_INVITE_LINK, { event_id: eventId }, 'xwa2_rotate_event_invite_link'),
 		getEventLinkPreview: url => www(WWW_GQL_IDS.GET_EVENT_LINK_PREVIEW, { url }, 'xwa2_get_event_link_preview'),
 		listPresetCoverImages: () => www(WWW_GQL_IDS.LIST_PRESET_COVER_IMAGES, {}, 'xwa2_list_preset_cover_images'),
 
-		
-		getBusinessProfileWebsiteShimUrl: bizJid =>
-			www(
-				WWW_GQL_IDS.GET_BUSINESS_PROFILE_WEBSITE_SHIM_URL,
-				{ biz_jid: bizJid },
-				'xwa2_get_business_profile_website_shim_url'
-			),
-		waWebBizCreateOrderJob: input =>
-			www(WWW_GQL_IDS.WA_WEB_BIZ_CREATE_ORDER_JOB, { input }, 'xwa2_wa_web_biz_create_order_job'),
-		waWebBizGraphqlRefreshCart: cartId =>
-			www(WWW_GQL_IDS.WA_WEB_BIZ_GRAPHQL_REFRESH_CART, { cart_id: cartId }, 'xwa2_wa_web_biz_graphql_refresh_cart'),
-		waWebBizQueryOrderJob: jobId =>
-			www(WWW_GQL_IDS.WA_WEB_BIZ_QUERY_ORDER_JOB, { job_id: jobId }, 'xwa2_wa_web_biz_query_order_job'),
-		whatsappCatalogReportProduct: (productId, reason) =>
-			www(
-				WWW_GQL_IDS.WHATSAPP_CATALOG_REPORT_PRODUCT,
-				{ product_id: productId, reason },
-				'xwa2_whatsapp_catalog_report_product'
-			),
-		brandIdsGetPhoneNumbers: brandId =>
-			www(WWW_GQL_IDS.BRAND_IDS_GET_PHONE_NUMBERS, { brand_id: brandId }, 'xwa2_brand_ids_get_phone_numbers'),
-		businessInteractionPills: bizJid =>
-			www(WWW_GQL_IDS.BUSINESS_INTERACTION_PILLS, { biz_jid: bizJid }, 'xwa2_business_interaction_pills'),
-		externalCtxAuthoriseWAChat: input =>
-			www(WWW_GQL_IDS.EXTERNAL_CTX_AUTHORISE_WA_CHAT, { input }, 'xwa2_external_ctx_authorise_wa_chat'),
-
-		
+		// ── Business / Catalog ────────────────────────────────────────────────
+		getBusinessProfileWebsiteShimUrl: bizJid => www(WWW_GQL_IDS.GET_BUSINESS_PROFILE_WEBSITE_SHIM_URL, { biz_jid: bizJid }, 'xwa2_get_business_profile_website_shim_url'),
+		waWebBizCreateOrderJob: input => www(WWW_GQL_IDS.WA_WEB_BIZ_CREATE_ORDER_JOB, { input }, 'xwa2_wa_web_biz_create_order_job'),
+		waWebBizGraphqlRefreshCart: cartId => www(WWW_GQL_IDS.WA_WEB_BIZ_GRAPHQL_REFRESH_CART, { cart_id: cartId }, 'xwa2_wa_web_biz_graphql_refresh_cart'),
+		waWebBizQueryOrderJob: jobId => www(WWW_GQL_IDS.WA_WEB_BIZ_QUERY_ORDER_JOB, { job_id: jobId }, 'xwa2_wa_web_biz_query_order_job'),
+		whatsappCatalogReportProduct: (productId, reason) => www(WWW_GQL_IDS.WHATSAPP_CATALOG_REPORT_PRODUCT, { product_id: productId, reason }, 'xwa2_whatsapp_catalog_report_product'),
+		brandIdsGetPhoneNumbers: brandId => www(WWW_GQL_IDS.BRAND_IDS_GET_PHONE_NUMBERS, { brand_id: brandId }, 'xwa2_brand_ids_get_phone_numbers'),
+		businessInteractionPills: bizJid => www(WWW_GQL_IDS.BUSINESS_INTERACTION_PILLS, { biz_jid: bizJid }, 'xwa2_business_interaction_pills'),
+		externalCtxAuthoriseWAChat: input => www(WWW_GQL_IDS.EXTERNAL_CTX_AUTHORISE_WA_CHAT, { input }, 'xwa2_external_ctx_authorise_wa_chat'),
+
+		// ── Payments (Brazil PIX) ─────────────────────────────────────────────
 		brGetAuthOptions: () => www(WWW_GQL_IDS.BR_GET_AUTH_OPTIONS, {}, 'xwa2_br_get_auth_options'),
 		brSaveCpf: cpf => www(WWW_GQL_IDS.BR_SAVE_CPF, { cpf }, 'xwa2_br_save_cpf'),
 		brCreateEnrollment: options => www(WWW_GQL_IDS.CREATE_ENROLLMENT, options, 'xwa2_create_enrollment'),
-		brCompleteEnrollmentRegistration: input =>
-			www(WWW_GQL_IDS.BR_COMPLETE_ENROLLMENT_REGISTRATION, { input }, 'xwa2_br_complete_enrollment_registration'),
-		brGetEnrollmentOptions: () =>
-			www(WWW_GQL_IDS.GET_ENROLLMENT_REGISTRATION_OPTIONS, {}, 'xwa2_get_enrollment_registration_options'),
-		brAuthorizePayment: input =>
-			www(WWW_GQL_IDS.BR_AUTHORIZE_BIOMETRIC_PAYMENT, { input }, 'xwa2_br_authorize_biometric_payment'),
+		brCompleteEnrollmentRegistration: input => www(WWW_GQL_IDS.BR_COMPLETE_ENROLLMENT_REGISTRATION, { input }, 'xwa2_br_complete_enrollment_registration'),
+		brGetEnrollmentOptions: () => www(WWW_GQL_IDS.GET_ENROLLMENT_REGISTRATION_OPTIONS, {}, 'xwa2_get_enrollment_registration_options'),
+		brAuthorizePayment: input => www(WWW_GQL_IDS.BR_AUTHORIZE_BIOMETRIC_PAYMENT, { input }, 'xwa2_br_authorize_biometric_payment'),
 		getPixBankList: () => www(WWW_GQL_IDS.GET_PIX_BANK_LIST, {}, 'xwa2_get_pix_bank_list'),
-		getMerchantPixInfo: merchantId =>
-			www(WWW_GQL_IDS.GET_MERCHANT_PIX_INFO, { merchant_id: merchantId }, 'xwa2_get_merchant_pix_info'),
-		completePixTransaction: input =>
-			www(WWW_GQL_IDS.COMPLETE_PIX_TRANSACTION, { input }, 'xwa2_complete_pix_transaction'),
+		getMerchantPixInfo: merchantId => www(WWW_GQL_IDS.GET_MERCHANT_PIX_INFO, { merchant_id: merchantId }, 'xwa2_get_merchant_pix_info'),
+		completePixTransaction: input => www(WWW_GQL_IDS.COMPLETE_PIX_TRANSACTION, { input }, 'xwa2_complete_pix_transaction'),
 		payWithPixPrecheck: input => www(WWW_GQL_IDS.PAY_WITH_PIX_PRECHECK, { input }, 'xwa2_pay_with_pix_precheck'),
 		paymentHealthChecks: () => www(WWW_GQL_IDS.PAYMENT_HEALTH_CHECKS, {}, 'xwa2_payment_health_checks'),
 		getPaymentKey: () => www(WWW_GQL_IDS.GET_PAYMENT_KEY, {}, 'xwa2_get_payment_key'),
 		genCreatePaymentKey: input => www(WWW_GQL_IDS.GEN_CREATE_PAYMENT_KEY, { input }, 'xwa2_gen_create_payment_key'),
 		genUpdatePaymentKey: input => www(WWW_GQL_IDS.GEN_UPDATE_PAYMENT_KEY, { input }, 'xwa2_gen_update_payment_key'),
-		genDeletePaymentKey: keyId =>
-			www(WWW_GQL_IDS.GEN_DELETE_PAYMENT_KEY, { key_id: keyId }, 'xwa2_gen_delete_payment_key'),
+		genDeletePaymentKey: keyId => www(WWW_GQL_IDS.GEN_DELETE_PAYMENT_KEY, { key_id: keyId }, 'xwa2_gen_delete_payment_key'),
 		getBillerPlans: billerId => www(WWW_GQL_IDS.GET_BILLER_PLANS, { biller_id: billerId }, 'xwa2_get_biller_plans'),
 		getBillReceipt: billId => www(WWW_GQL_IDS.GET_BILL_RECEIPT, { bill_id: billId }, 'xwa2_get_bill_receipt'),
-		getBillComplaintUrl: billId =>
-			www(WWW_GQL_IDS.GET_BILL_COMPLAINT_URL, { bill_id: billId }, 'xwa2_get_bill_complaint_url'),
+		getBillComplaintUrl: billId => www(WWW_GQL_IDS.GET_BILL_COMPLAINT_URL, { bill_id: billId }, 'xwa2_get_bill_complaint_url'),
 		paymentReminderCreate: input => www(WWW_GQL_IDS.PAYMENT_REMINDER_CREATE, { input }, 'xwa2_payment_reminder_create'),
-		paymentReminderGet: reminderId =>
-			www(WWW_GQL_IDS.PAYMENT_REMINDER_GET, { reminder_id: reminderId }, 'xwa2_payment_reminder_get'),
-		paymentReminderCancel: reminderId =>
-			www(WWW_GQL_IDS.PAYMENT_REMINDER_CANCEL, { reminder_id: reminderId }, 'xwa2_payment_reminder_cancel'),
-		paymentReminderStop: reminderId =>
-			www(WWW_GQL_IDS.PAYMENT_REMINDER_STOP, { reminder_id: reminderId }, 'xwa2_payment_reminder_stop'),
-		genShareRemittanceIntent: input =>
-			www(
-				WWW_GQL_IDS.GEN_SHARE_REMITTANCE_TRANSACTION_INTENT,
-				{ input },
-				'xwa2_gen_share_remittance_transaction_intent'
-			),
-		getRemittanceTransactionDetails: txId =>
-			www(
-				WWW_GQL_IDS.GET_REMITTANCE_TRANSACTION_DETAILS,
-				{ transaction_id: txId },
-				'xwa2_get_remittance_transaction_details'
-			),
-		saveRemittancePaymentMessageId: input =>
-			www(WWW_GQL_IDS.SAVE_REMITTANCE_PAYMENT_MESSAGE_ID, { input }, 'xwa2_save_remittance_payment_message_id'),
-		saveSenderPaymentMessagePreference: preference =>
-			www(
-				WWW_GQL_IDS.SAVE_SENDER_PAYMENT_MESSAGE_PREFERENCE,
-				{ preference },
-				'xwa2_save_sender_payment_message_preference'
-			),
-		getEligibility: (feature = null) =>
-			www(WWW_GQL_IDS.GET_ELIGIBILITY, feature ? { feature } : {}, 'xwa2_get_eligibility'),
-		enrollAndGetIncentiveReferralId: input =>
-			www(WWW_GQL_IDS.ENROLL_AND_GET_INCENTIVE_REFERRAL_ID, { input }, 'xwa2_enroll_and_get_incentive_referral_id'),
-		getSubscriptionsAndFeatureFlags: () =>
-			www(WWW_GQL_IDS.GET_SUBSCRIPTIONS_AND_FEATURE_FLAGS, {}, 'xwa2_get_subscriptions_and_feature_flags'),
-
-		
+		paymentReminderGet: reminderId => www(WWW_GQL_IDS.PAYMENT_REMINDER_GET, { reminder_id: reminderId }, 'xwa2_payment_reminder_get'),
+		paymentReminderCancel: reminderId => www(WWW_GQL_IDS.PAYMENT_REMINDER_CANCEL, { reminder_id: reminderId }, 'xwa2_payment_reminder_cancel'),
+		paymentReminderStop: reminderId => www(WWW_GQL_IDS.PAYMENT_REMINDER_STOP, { reminder_id: reminderId }, 'xwa2_payment_reminder_stop'),
+		genShareRemittanceIntent: input => www(WWW_GQL_IDS.GEN_SHARE_REMITTANCE_TRANSACTION_INTENT, { input }, 'xwa2_gen_share_remittance_transaction_intent'),
+		getRemittanceTransactionDetails: txId => www(WWW_GQL_IDS.GET_REMITTANCE_TRANSACTION_DETAILS, { transaction_id: txId }, 'xwa2_get_remittance_transaction_details'),
+		saveRemittancePaymentMessageId: input => www(WWW_GQL_IDS.SAVE_REMITTANCE_PAYMENT_MESSAGE_ID, { input }, 'xwa2_save_remittance_payment_message_id'),
+		saveSenderPaymentMessagePreference: preference => www(WWW_GQL_IDS.SAVE_SENDER_PAYMENT_MESSAGE_PREFERENCE, { preference }, 'xwa2_save_sender_payment_message_preference'),
+		getEligibility: (feature = null) => www(WWW_GQL_IDS.GET_ELIGIBILITY, feature ? { feature } : {}, 'xwa2_get_eligibility'),
+		enrollAndGetIncentiveReferralId: input => www(WWW_GQL_IDS.ENROLL_AND_GET_INCENTIVE_REFERRAL_ID, { input }, 'xwa2_enroll_and_get_incentive_referral_id'),
+		getSubscriptionsAndFeatureFlags: () => www(WWW_GQL_IDS.GET_SUBSCRIPTIONS_AND_FEATURE_FLAGS, {}, 'xwa2_get_subscriptions_and_feature_flags'),
+
+		// ── Payments (UPI India) ──────────────────────────────────────────────
 		getUpiAccounts: () => www(WWW_GQL_IDS.GET_UPI_ACCOUNTS, {}, 'xwa2_get_upi_accounts'),
 		getUpiLiteDetails: () => www(WWW_GQL_IDS.GET_UPI_LITE_DETAILS, {}, 'xwa2_get_upi_lite_details'),
 		getUpiToken: upiAccountId => www(WWW_GQL_IDS.GET_UPI_TOKEN, { upi_account_id: upiAccountId }, 'xwa2_get_upi_token'),
-		getUpiPurposeLimitingKey: () =>
-			www(WWW_GQL_IDS.GET_UPI_PURPOSE_LIMITING_KEY, {}, 'xwa2_get_upi_purpose_limiting_key'),
+		getUpiPurposeLimitingKey: () => www(WWW_GQL_IDS.GET_UPI_PURPOSE_LIMITING_KEY, {}, 'xwa2_get_upi_purpose_limiting_key'),
 		upiCreateMandate: input => www(WWW_GQL_IDS.UPI_CREATE_MANDATE, { input }, 'xwa2_upi_create_mandate'),
-		upiAcceptMandate: mandateId =>
-			www(WWW_GQL_IDS.UPI_ACCEPT_MANDATE, { mandate_id: mandateId }, 'xwa2_upi_accept_mandate'),
-		upiRejectMandate: mandateId =>
-			www(WWW_GQL_IDS.UPI_REJECT_MANDATE, { mandate_id: mandateId }, 'xwa2_upi_reject_mandate'),
-		upiExecuteMandate: mandateId =>
-			www(WWW_GQL_IDS.UPI_EXECUTE_MANDATE, { mandate_id: mandateId }, 'xwa2_upi_execute_mandate'),
-		upiPauseMandate: mandateId =>
-			www(WWW_GQL_IDS.UPI_PAUSE_MANDATE, { mandate_id: mandateId }, 'xwa2_upi_pause_mandate'),
-		upiResumeMandate: mandateId =>
-			www(WWW_GQL_IDS.UPI_RESUME_MANDATE, { mandate_id: mandateId }, 'xwa2_upi_resume_mandate'),
-		upiRevokeMandate: mandateId =>
-			www(WWW_GQL_IDS.UPI_REVOKE_MANDATE, { mandate_id: mandateId }, 'xwa2_upi_revoke_mandate'),
+		upiAcceptMandate: mandateId => www(WWW_GQL_IDS.UPI_ACCEPT_MANDATE, { mandate_id: mandateId }, 'xwa2_upi_accept_mandate'),
+		upiRejectMandate: mandateId => www(WWW_GQL_IDS.UPI_REJECT_MANDATE, { mandate_id: mandateId }, 'xwa2_upi_reject_mandate'),
+		upiExecuteMandate: mandateId => www(WWW_GQL_IDS.UPI_EXECUTE_MANDATE, { mandate_id: mandateId }, 'xwa2_upi_execute_mandate'),
+		upiPauseMandate: mandateId => www(WWW_GQL_IDS.UPI_PAUSE_MANDATE, { mandate_id: mandateId }, 'xwa2_upi_pause_mandate'),
+		upiResumeMandate: mandateId => www(WWW_GQL_IDS.UPI_RESUME_MANDATE, { mandate_id: mandateId }, 'xwa2_upi_resume_mandate'),
+		upiRevokeMandate: mandateId => www(WWW_GQL_IDS.UPI_REVOKE_MANDATE, { mandate_id: mandateId }, 'xwa2_upi_revoke_mandate'),
 		pmtaGetAiControls: () => www(WWW_GQL_IDS.PMTA_GET_AI_CONTROLS, {}, 'xwa2_pmta_get_ai_controls'),
 		pmtaSetAiControls: controls => www(WWW_GQL_IDS.PMTA_SET_AI_CONTROLS, { controls }, 'xwa2_pmta_set_ai_controls'),
 
-		
-		wamoSubQueryStatus: newsletterJid =>
-			www(WWW_GQL_IDS.WAMO_SUB_QUERY_STATUS, { newsletter_jid: newsletterJid }, 'xwa2_wamo_sub_query_status'),
-		wamoSubCancelSubscription: (newsletterJid, subscriptionId) =>
-			www(
-				WWW_GQL_IDS.WAMO_SUB_CANCEL_SUBSCRIPTION,
-				{ newsletter_jid: newsletterJid, subscription_id: subscriptionId },
-				'xwa2_wamo_sub_cancel_subscription'
-			),
-		wamoSubOverrideStatus: (newsletterJid, status) =>
-			www(
-				WWW_GQL_IDS.WAMO_SUB_OVERRIDE_STATUS,
-				{ newsletter_jid: newsletterJid, status },
-				'xwa2_wamo_sub_override_status'
-			),
-		wamoAfsSubscriptionInfo: newsletterJid =>
-			www(WWW_GQL_IDS.WAMO_AFS_SUBSCRIPTION_INFO, { newsletter_jid: newsletterJid }, 'xwa2_wamo_afs_subscription_info'),
-		wamoPromoIdQuery: newsletterJid =>
-			www(WWW_GQL_IDS.WAMO_PROMO_ID_QUERY, { newsletter_jid: newsletterJid }, 'xwa2_wamo_promo_id_query'),
-		wamoPromoIdSet: (newsletterJid, promoId) =>
-			www(
-				WWW_GQL_IDS.WAMO_PROMO_ID_SET,
-				{ newsletter_jid: newsletterJid, promo_id: promoId },
-				'xwa2_wamo_promo_id_set'
-			),
-		wamoPromoIdDelete: newsletterJid =>
-			www(WWW_GQL_IDS.WAMO_PROMO_ID_DELETE, { newsletter_jid: newsletterJid }, 'xwa2_wamo_promo_id_delete'),
-
-		
+		// ── Wamo commerce (via www schema) ────────────────────────────────────
+		wamoSubQueryStatus: newsletterJid => www(WWW_GQL_IDS.WAMO_SUB_QUERY_STATUS, { newsletter_jid: newsletterJid }, 'xwa2_wamo_sub_query_status'),
+		wamoSubCancelSubscription: (newsletterJid, subscriptionId) => www(WWW_GQL_IDS.WAMO_SUB_CANCEL_SUBSCRIPTION, { newsletter_jid: newsletterJid, subscription_id: subscriptionId }, 'xwa2_wamo_sub_cancel_subscription'),
+		wamoSubOverrideStatus: (newsletterJid, status) => www(WWW_GQL_IDS.WAMO_SUB_OVERRIDE_STATUS, { newsletter_jid: newsletterJid, status }, 'xwa2_wamo_sub_override_status'),
+		wamoAfsSubscriptionInfo: newsletterJid => www(WWW_GQL_IDS.WAMO_AFS_SUBSCRIPTION_INFO, { newsletter_jid: newsletterJid }, 'xwa2_wamo_afs_subscription_info'),
+		wamoPromoIdQuery: newsletterJid => www(WWW_GQL_IDS.WAMO_PROMO_ID_QUERY, { newsletter_jid: newsletterJid }, 'xwa2_wamo_promo_id_query'),
+		wamoPromoIdSet: (newsletterJid, promoId) => www(WWW_GQL_IDS.WAMO_PROMO_ID_SET, { newsletter_jid: newsletterJid, promo_id: promoId }, 'xwa2_wamo_promo_id_set'),
+		wamoPromoIdDelete: newsletterJid => www(WWW_GQL_IDS.WAMO_PROMO_ID_DELETE, { newsletter_jid: newsletterJid }, 'xwa2_wamo_promo_id_delete'),
+
+		// ── User / account ────────────────────────────────────────────────────
 		facebookAccountName: () => www(WWW_GQL_IDS.FACEBOOK_ACCOUNT_NAME, {}, 'xwa2_facebook_account_name'),
 		instagramAccountName: () => www(WWW_GQL_IDS.INSTAGRAM_ACCOUNT_NAME, {}, 'xwa2_instagram_account_name'),
 		getSignupMetadata: () => www(WWW_GQL_IDS.GET_SIGNUP_METADATA, {}, 'xwa2_get_signup_metadata'),
 		registerInit: input => www(WWW_GQL_IDS.REGISTER_INIT, { input }, 'xwa2_register_init'),
 		registerAllAccounts: () => www(WWW_GQL_IDS.REGISTER_ALL_ACCOUNTS, {}, 'xwa2_register_all_accounts'),
-		checkDeviceRegistration: deviceId =>
-			www(WWW_GQL_IDS.CHECK_DEVICE_REGISTRATION, { device_id: deviceId }, 'xwa2_check_device_registration'),
-		canonicalEntQueryFeature: feature =>
-			www(WWW_GQL_IDS.CANONICAL_ENT_QUERY_FEATURE, { feature }, 'xwa2_canonical_ent_query_feature'),
-		canonicalEntSetupFeature: (feature, options = {}) =>
-			www(WWW_GQL_IDS.CANONICAL_ENT_SETUP_FEATURE, { feature, ...options }, 'xwa2_canonical_ent_setup_feature'),
-		canonicalEntTeardownFeature: feature =>
-			www(WWW_GQL_IDS.CANONICAL_ENT_TEARDOWN_FEATURE, { feature }, 'xwa2_canonical_ent_teardown_feature'),
-		wwwCanonicalUserValid: token =>
-			www(WWW_GQL_IDS.WWW_CANONICAL_USER_VALID, { token }, 'xwa2_www_canonical_user_valid'),
+		checkDeviceRegistration: deviceId => www(WWW_GQL_IDS.CHECK_DEVICE_REGISTRATION, { device_id: deviceId }, 'xwa2_check_device_registration'),
+		canonicalEntQueryFeature: feature => www(WWW_GQL_IDS.CANONICAL_ENT_QUERY_FEATURE, { feature }, 'xwa2_canonical_ent_query_feature'),
+		canonicalEntSetupFeature: (feature, options = {}) => www(WWW_GQL_IDS.CANONICAL_ENT_SETUP_FEATURE, { feature, ...options }, 'xwa2_canonical_ent_setup_feature'),
+		canonicalEntTeardownFeature: feature => www(WWW_GQL_IDS.CANONICAL_ENT_TEARDOWN_FEATURE, { feature }, 'xwa2_canonical_ent_teardown_feature'),
+		wwwCanonicalUserValid: token => www(WWW_GQL_IDS.WWW_CANONICAL_USER_VALID, { token }, 'xwa2_www_canonical_user_valid'),
 		waffleUserAgeCheck: () => www(WWW_GQL_IDS.WAFFLE_USER_AGE_CHECK, {}, 'xwa2_waffle_user_age_check'),
 		getAiPredictedAge: () => www(WWW_GQL_IDS.GET_AI_PREDICTED_AGE, {}, 'xwa2_get_ai_predicted_age'),
 
-		
+		// ── Support / misc ────────────────────────────────────────────────────
 		submitBugReport: input => www(WWW_GQL_IDS.SUBMIT_BUG_REPORT, { input }, 'xwa2_submit_bug_report'),
 		supportContactForm: input => www(WWW_GQL_IDS.SUPPORT_CONTACT_FORM, { input }, 'xwa2_support_contact_form'),
-		createGroupSuspensionAppeal: (groupJid, reason) =>
-			www(
-				WWW_GQL_IDS.CREATE_GROUP_SUSPENSION_APPEAL,
-				{ group_jid: groupJid, reason },
-				'xwa2_create_group_suspension_appeal'
-			),
+		createGroupSuspensionAppeal: (groupJid, reason) => www(WWW_GQL_IDS.CREATE_GROUP_SUSPENSION_APPEAL, { group_jid: groupJid, reason }, 'xwa2_create_group_suspension_appeal'),
 		createDogfoodingTask: input => www(WWW_GQL_IDS.CREATE_DOGFOODING_TASK, { input }, 'xwa2_create_dogfooding_task'),
 		hatchChannelLink: input => www(WWW_GQL_IDS.HATCH_CHANNEL_LINK, { input }, 'xwa2_hatch_channel_link'),
-		hatchChannelMetadata: channelId =>
-			www(WWW_GQL_IDS.HATCH_CHANNEL_METADATA, { channel_id: channelId }, 'xwa2_hatch_channel_metadata'),
-		oxygenChannelOptIn: channelId =>
-			www(WWW_GQL_IDS.OXYGEN_CHANNEL_OPT_IN, { channel_id: channelId }, 'xwa2_oxygen_channel_opt_in'),
-		oxygenChannelOptOut: channelId =>
-			www(WWW_GQL_IDS.OXYGEN_CHANNEL_OPT_OUT, { channel_id: channelId }, 'xwa2_oxygen_channel_opt_out'),
-		oxygenChannelStatus: channelId =>
-			www(WWW_GQL_IDS.OXYGEN_CHANNEL_STATUS, { channel_id: channelId }, 'xwa2_oxygen_channel_status'),
+		hatchChannelMetadata: channelId => www(WWW_GQL_IDS.HATCH_CHANNEL_METADATA, { channel_id: channelId }, 'xwa2_hatch_channel_metadata'),
+		oxygenChannelOptIn: channelId => www(WWW_GQL_IDS.OXYGEN_CHANNEL_OPT_IN, { channel_id: channelId }, 'xwa2_oxygen_channel_opt_in'),
+		oxygenChannelOptOut: channelId => www(WWW_GQL_IDS.OXYGEN_CHANNEL_OPT_OUT, { channel_id: channelId }, 'xwa2_oxygen_channel_opt_out'),
+		oxygenChannelStatus: channelId => www(WWW_GQL_IDS.OXYGEN_CHANNEL_STATUS, { channel_id: channelId }, 'xwa2_oxygen_channel_status'),
 		paslGetLoggerConfig: () => www(WWW_GQL_IDS.PASL_GET_LOGGER_CONFIG, {}, 'xwa2_pasl_get_logger_config'),
-		quickPromotionBatchFetch: input =>
-			www(WWW_GQL_IDS.QUICK_PROMOTION_BATCH_FETCH, { input }, 'xwa2_quick_promotion_batch_fetch'),
+		quickPromotionBatchFetch: input => www(WWW_GQL_IDS.QUICK_PROMOTION_BATCH_FETCH, { input }, 'xwa2_quick_promotion_batch_fetch'),
 		waQuickPromotionLog: events => www(WWW_GQL_IDS.WA_QUICK_PROMOTION_LOG, { events }, 'xwa2_wa_quick_promotion_log'),
-		waSupportMessageFeedback: input =>
-			www(WWW_GQL_IDS.WA_SUPPORT_MESSAGE_FEEDBACK, { input }, 'xwa2_wa_support_message_feedback'),
-		waGizmoPostMetadata: postId =>
-			www(WWW_GQL_IDS.WA_GIZMO_POST_METADATA, { post_id: postId }, 'xwa2_wa_gizmo_post_metadata'),
-		unifiedConversationStarters: chatJid =>
-			www(WWW_GQL_IDS.UNIFIED_CONVERSATION_STARTERS, { chat_jid: chatJid }, 'xwa2_unified_conversation_starters'),
-		getSubscribedTasksForThread: threadId =>
-			www(WWW_GQL_IDS.GET_SUBSCRIBED_TASKS_FOR_THREAD, { thread_id: threadId }, 'xwa2_get_subscribed_tasks_for_thread'),
-		editGenAiTask: (taskId, updates) =>
-			www(WWW_GQL_IDS.EDIT_GEN_AI_TASK, { task_id: taskId, ...updates }, 'xwa2_edit_gen_ai_task'),
-		deleteGenAiTasks: taskIds =>
-			www(WWW_GQL_IDS.DELETE_GEN_AI_TASKS, { task_ids: taskIds }, 'xwa2_delete_gen_ai_tasks'),
+		waSupportMessageFeedback: input => www(WWW_GQL_IDS.WA_SUPPORT_MESSAGE_FEEDBACK, { input }, 'xwa2_wa_support_message_feedback'),
+		waGizmoPostMetadata: postId => www(WWW_GQL_IDS.WA_GIZMO_POST_METADATA, { post_id: postId }, 'xwa2_wa_gizmo_post_metadata'),
+		unifiedConversationStarters: chatJid => www(WWW_GQL_IDS.UNIFIED_CONVERSATION_STARTERS, { chat_jid: chatJid }, 'xwa2_unified_conversation_starters'),
+		getSubscribedTasksForThread: threadId => www(WWW_GQL_IDS.GET_SUBSCRIBED_TASKS_FOR_THREAD, { thread_id: threadId }, 'xwa2_get_subscribed_tasks_for_thread'),
+		editGenAiTask: (taskId, updates) => www(WWW_GQL_IDS.EDIT_GEN_AI_TASK, { task_id: taskId, ...updates }, 'xwa2_edit_gen_ai_task'),
+		deleteGenAiTasks: taskIds => www(WWW_GQL_IDS.DELETE_GEN_AI_TASKS, { task_ids: taskIds }, 'xwa2_delete_gen_ai_tasks'),
 		deleteUserBillAccount: () => www(WWW_GQL_IDS.DELETE_USER_BILL_ACCOUNT, {}, 'xwa2_delete_user_bill_account'),
 		metaPoiTypeAhead: query => www(WWW_GQL_IDS.META_POI_TYPE_AHEAD, { query }, 'xwa2_meta_poi_type_ahead'),
 		metaConfigFetch: () => www(WWW_GQL_IDS.META_CONFIG_FETCH, {}, 'xwa2_meta_config_fetch'),
 
-		
-		bizAlertsNotificationList: () =>
-			fb(FACEBOOK_GQL_IDS.BIZ_ALERTS_NOTIFICATION_LIST, {}, 'xwa2_biz_alerts_notification_list'),
-		bizAlertsUpdate: (alertId, read) =>
-			fb(FACEBOOK_GQL_IDS.BIZ_ALERTS_UPDATE, { alert_id: alertId, read }, 'xwa2_biz_alerts_update'),
-		ctwaAdsContextBiz: bizJid =>
-			fb(FACEBOOK_GQL_IDS.CTWA_ADS_CONTEXT_BIZ, { biz_jid: bizJid }, 'xwa2_ctwa_ads_context_biz'),
-		digitalContentIapPurchaseQuote: input =>
-			fb(FACEBOOK_GQL_IDS.DIGITAL_CONTENT_IAP_PURCHASE_QUOTE, { input }, 'xwa2_digital_content_iap_purchase_quote'),
+		// ── Facebook schema ───────────────────────────────────────────────────
+		bizAlertsNotificationList: () => fb(FACEBOOK_GQL_IDS.BIZ_ALERTS_NOTIFICATION_LIST, {}, 'xwa2_biz_alerts_notification_list'),
+		bizAlertsUpdate: (alertId, read) => fb(FACEBOOK_GQL_IDS.BIZ_ALERTS_UPDATE, { alert_id: alertId, read }, 'xwa2_biz_alerts_update'),
+		ctwaAdsContextBiz: bizJid => fb(FACEBOOK_GQL_IDS.CTWA_ADS_CONTEXT_BIZ, { biz_jid: bizJid }, 'xwa2_ctwa_ads_context_biz'),
+		digitalContentIapPurchaseQuote: input => fb(FACEBOOK_GQL_IDS.DIGITAL_CONTENT_IAP_PURCHASE_QUOTE, { input }, 'xwa2_digital_content_iap_purchase_quote'),
 		getCompliance: () => fb(FACEBOOK_GQL_IDS.GET_COMPLIANCE, {}, 'xwa2_get_compliance'),
-		setCompliance: (complianceType, accepted) =>
-			fb(FACEBOOK_GQL_IDS.SET_COMPLIANCE, { compliance_type: complianceType, accepted }, 'xwa2_set_compliance'),
+		setCompliance: (complianceType, accepted) => fb(FACEBOOK_GQL_IDS.SET_COMPLIANCE, { compliance_type: complianceType, accepted }, 'xwa2_set_compliance'),
 		getCustomUrls: () => fb(FACEBOOK_GQL_IDS.GET_CUSTOM_URLS, {}, 'xwa2_get_custom_urls'),
-		getDcpProducts: (categoryId = null) =>
-			fb(FACEBOOK_GQL_IDS.GET_DCP_PRODUCTS, categoryId ? { category_id: categoryId } : {}, 'xwa2_get_dcp_products'),
-		acDcCreateCommerceNonce: input =>
-			fb(FACEBOOK_GQL_IDS.ACDC_CREATE_COMMERCE_NONCE, { input }, 'xwa2_acdc_create_commerce_nonce'),
-		fbUsernameRecommendations: (source = null) =>
-			fb(FACEBOOK_GQL_IDS.USERNAME_RECOMMENDATIONS, source ? { source } : {}, 'xwa2_username_recommendations'),
-
-		
+		getDcpProducts: (categoryId = null) => fb(FACEBOOK_GQL_IDS.GET_DCP_PRODUCTS, categoryId ? { category_id: categoryId } : {}, 'xwa2_get_dcp_products'),
+		acDcCreateCommerceNonce: input => fb(FACEBOOK_GQL_IDS.ACDC_CREATE_COMMERCE_NONCE, { input }, 'xwa2_acdc_create_commerce_nonce'),
+		fbUsernameRecommendations: (source = null) => fb(FACEBOOK_GQL_IDS.USERNAME_RECOMMENDATIONS, source ? { source } : {}, 'xwa2_username_recommendations'),
+
+		// ── Wamo platform schema (form-encoded, separate endpoint) ────────────
 		wamoUserBasic: () => wamo(WAMO_GQL_IDS.USER_BASIC, {}, 'xwa2_wamo_user_basic'),
 		wamoCreateUser: input => wamo(WAMO_GQL_IDS.CREATE_USER, { input }, 'xwa2_wamo_create_user'),
 		wamoDeleteUser: () => wamo(WAMO_GQL_IDS.DELETE_USER, {}, 'xwa2_wamo_delete_user'),
@@ -737,121 +637,14 @@ const makeGraphQLSocket = sock => {
 		wamoUnhidePage: pageId => wamo(WAMO_GQL_IDS.UNHIDE_PAGE, { page_id: pageId }, 'xwa2_wamo_unhide_page'),
 		wamoUnhidePageV2: pageId => wamo(WAMO_GQL_IDS.UNHIDE_PAGE_V2, { page_id: pageId }, 'xwa2_wamo_unhide_page_v2'),
 		wamoHidePromo: promoId => wamo(WAMO_GQL_IDS.HIDE_PROMO, { promo_id: promoId }, 'xwa2_wamo_hide_promo'),
-		wamoReportPromo: (promoId, reason) =>
-			wamo(WAMO_GQL_IDS.REPORT_PROMO, { promo_id: promoId, reason }, 'xwa2_wamo_report_promo'),
-		wamoStartViewerSession: pageId =>
-			wamo(WAMO_GQL_IDS.START_VIEWER_SESSION, { page_id: pageId }, 'xwa2_wamo_start_viewer_session'),
-		wamoBloksGetLayout: (layoutId, context = {}) =>
-			wamo(WAMO_GQL_IDS.BLOKS_GET_LAYOUT, { layout_id: layoutId, ...context }, 'xwa2_wamo_bloks_get_layout'),
+		wamoReportPromo: (promoId, reason) => wamo(WAMO_GQL_IDS.REPORT_PROMO, { promo_id: promoId, reason }, 'xwa2_wamo_report_promo'),
+		wamoStartViewerSession: pageId => wamo(WAMO_GQL_IDS.START_VIEWER_SESSION, { page_id: pageId }, 'xwa2_wamo_start_viewer_session'),
+		wamoBloksGetLayout: (layoutId, context = {}) => wamo(WAMO_GQL_IDS.BLOKS_GET_LAYOUT, { layout_id: layoutId, ...context }, 'xwa2_wamo_bloks_get_layout'),
 		wamoDyiJobCreate: input => wamo(WAMO_GQL_IDS.DYI_JOB_CREATE, { input }, 'xwa2_wamo_dyi_job_create'),
 		wamoDyiJobDelete: jobId => wamo(WAMO_GQL_IDS.DYI_JOB_DELETE, { job_id: jobId }, 'xwa2_wamo_dyi_job_delete'),
 		wamoDyiJobStatus: jobId => wamo(WAMO_GQL_IDS.DYI_JOB_STATUS, { job_id: jobId }, 'xwa2_wamo_dyi_job_status'),
 
-		
-		metaAiFeedback: (messageId, rating, input = {}) =>
-			www(CLIENT_PERSIST_GQL_IDS.META_AI_FEEDBACK, { message_id: messageId, rating, ...input }, null),
-		metaAiStopGeneration: requestId =>
-			www(CLIENT_PERSIST_GQL_IDS.META_AI_STOP_GENERATION, { request_id: requestId }, null),
-		metaAiModesQuery: () => www(CLIENT_PERSIST_GQL_IDS.META_AI_MODES_QUERY, {}, null),
-		fetchMetaAiModes: () => www(CLIENT_PERSIST_GQL_IDS.FETCH_META_AI_MODES, {}, null),
-		metaAiRichPlaceDetails: placeId =>
-			www(CLIENT_PERSIST_GQL_IDS.META_AI_RICH_PLACE_DETAILS, { place_id: placeId }, null),
-		metaAiSideBySideSurveyResponse: input =>
-			www(CLIENT_PERSIST_GQL_IDS.META_AI_SIDE_BY_SIDE_SURVEY_RESPONSE, { input }, null),
-		metaAiBizAgentVoiceAttachments: (agentId, attachments) =>
-			www(CLIENT_PERSIST_GQL_IDS.META_AI_BIZ_AGENT_VOICE_ATTACHMENTS, { agent_id: agentId, attachments }, null),
-		metaAiCustomizationGenAiSetMode: (chatJid, mode) =>
-			www(CLIENT_PERSIST_GQL_IDS.META_AI_CUSTOMIZATION_GEN_AI_SET_MODE, { chat_jid: chatJid, mode }, null),
-		metaAiIntentCardNuxEligibilityReset: () =>
-			www(CLIENT_PERSIST_GQL_IDS.META_AI_INTENT_CARD_NUX_ELIGIBILITY_RESET, {}, null),
-		metaAiIntentCardNuxImpression: input =>
-			www(CLIENT_PERSIST_GQL_IDS.META_AI_INTENT_CARD_NUX_IMPRESSION, { input }, null),
-		metaAiIntentCardNuxImpressionQuery: () =>
-			www(CLIENT_PERSIST_GQL_IDS.META_AI_INTENT_CARD_NUX_IMPRESSION_QUERY, {}, null),
-
-		
-		maiUnifiedUser: () => www(CLIENT_PERSIST_GQL_IDS.MAI_UNIFIED_USER, {}, null),
-		maiUnifiedUserQuery: () => www(CLIENT_PERSIST_GQL_IDS.MAI_UNIFIED_USER_QUERY, {}, null),
-		maiUnifiedUserReset: () => www(CLIENT_PERSIST_GQL_IDS.MAI_UNIFIED_USER_RESET, {}, null),
-
-		
-		memuProfileQuery: () => www(CLIENT_PERSIST_GQL_IDS.MEMU_PROFILE_QUERY, {}, null),
-		memuUpdateProfile: input => www(CLIENT_PERSIST_GQL_IDS.MEMU_UPDATE_PROFILE, { input }, null),
-		memuPreviewPhoto: input => www(CLIENT_PERSIST_GQL_IDS.MEMU_PREVIEW_PHOTO, { input }, null),
-		updateMemuSelfie: input => www(CLIENT_PERSIST_GQL_IDS.UPDATE_MEMU_SELFIE, { input }, null),
-		addMemuProfilePhotos: photos => www(CLIENT_PERSIST_GQL_IDS.ADD_MEMU_PROFILE_PHOTOS, { photos }, null),
-		createMemuProfile: input => www(CLIENT_PERSIST_GQL_IDS.CREATE_MEMU_PROFILE, { input }, null),
-		fbMemuPermissionQuery: () => www(CLIENT_PERSIST_GQL_IDS.FB_MEMU_PERMISSION_QUERY, {}, null),
-		getMemuStickerById: stickerId =>
-			www(CLIENT_PERSIST_GQL_IDS.GET_MEMU_STICKER_BY_ID, { sticker_id: stickerId }, null),
-		genAiVerifyMemuPhotos: photos => www(CLIENT_PERSIST_GQL_IDS.GEN_AI_VERIFY_MEMU_PHOTOS, { photos }, null),
-		genAiMeMenuUpdateVoice: (voiceId, options = {}) =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_MEMU_UPDATE_VOICE, { voice_id: voiceId, ...options }, null),
-		genAiSocialEntityDetails: entityId =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_SOCIAL_ENTITY_DETAILS, { entity_id: entityId }, null),
-
-		
-		genAiImagineGenerate: (prompt, options = {}) =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_GENERATE, { prompt, ...options }, null),
-		genAiImagineGenerateFlash: (prompt, options = {}) =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_GENERATE_FLASH, { prompt, ...options }, null),
-		genAiImagineGenerateStreaming: (prompt, options = {}) =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_GENERATE_STREAMING, { prompt, ...options }, null),
-		genAiImagineGenerateFromImage: (imageId, prompt, options = {}) =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_GENERATE_FROM_IMAGE, { image_id: imageId, prompt, ...options }, null),
-		genAiImagineRegenerate: (imageId, options = {}) =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_REGENERATE, { image_id: imageId, ...options }, null),
-		genAiImagineEdit: (imageId, prompt, options = {}) =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_EDIT, { image_id: imageId, prompt, ...options }, null),
-		genAiImagineCanvasApi: (canvasId, input = {}) =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_CANVAS_API, { canvas_id: canvasId, ...input }, null),
-		genAiImagineInspirationCanvasApi: input =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_INSPIRATION_CANVAS_API, { input }, null),
-		genAiImagineSuggestions: context => www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_SUGGESTIONS, { context }, null),
-		genAiImagineDownloadMedia: mediaId =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_DOWNLOAD_MEDIA, { media_id: mediaId }, null),
-		genAiImagineSendMediaToChat: (chatJid, mediaId) =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_SEND_MEDIA_TO_CHAT, { chat_jid: chatJid, media_id: mediaId }, null),
-		genAiImagineBulkSendMediaToChat: (chatJids, mediaId) =>
-			www(
-				CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_BULK_SEND_MEDIA_TO_CHAT,
-				{ chat_jids: chatJids, media_id: mediaId },
-				null
-			),
-		genAiImagineHasMemuProfile: () => www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_HAS_MEMU_PROFILE, {}, null),
-		genAiImagineUpdateMemuProfilePermission: permission =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_UPDATE_MEMU_PROFILE_PERMISSION, { permission }, null),
-		genAiImaginePromptSummarization: prompt =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_PROMPT_SUMMARIZATION, { prompt }, null),
-		genAiImagineRestyleSections: (imageId, sections) =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_IMAGINE_RESTYLE_SECTIONS, { image_id: imageId, sections }, null),
-		genAiImagineBulkFor3pIntents: input => www(WWW_GQL_IDS.GEN_AI_IMAGINE_3P_FOR_INTENTS, { input }, null),
-		dropInImagineGenerate: (prompt, options = {}) =>
-			www(CLIENT_PERSIST_GQL_IDS.DROP_IN_IMAGINE_GENERATE, { prompt, ...options }, null),
-
-		
-		genAiEditAnimate: (imageId, options = {}) =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_EDIT_ANIMATE, { image_id: imageId, ...options }, null),
-		genAiEditBackdropSuggestions: imageId =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_EDIT_BACKDROP_SUGGESTIONS, { image_id: imageId }, null),
-		genAiEditImageBackdrop: (imageId, backdropId, options = {}) =>
-			www(
-				CLIENT_PERSIST_GQL_IDS.GEN_AI_EDIT_IMAGE_BACKDROP,
-				{ image_id: imageId, backdrop_id: backdropId, ...options },
-				null
-			),
-		genAiEditSuggestions: imageId => www(CLIENT_PERSIST_GQL_IDS.GEN_AI_EDIT_SUGGESTIONS, { image_id: imageId }, null),
-		genAiEditUploadAuthenticImage: imageData =>
-			www(CLIENT_PERSIST_GQL_IDS.GEN_AI_EDIT_UPLOAD_AUTHENTIC_IMAGE, { image_data: imageData }, null),
-
-		
-		immersiveCreationComplete: input => www(WWW_GQL_IDS.IMMERSIVE_CREATION_COMPLETE, { input }, null),
-		immersiveCreationConfig: () => www(WWW_GQL_IDS.IMMERSIVE_CREATION_CONFIG, {}, null),
-
-		
-		simpleEcho: input => www(CLIENT_PERSIST_GQL_IDS.SIMPLE_ECHO, { input }, null),
-
-		
+		// ── ID dictionaries (for raw access) ─────────────────────────────────
 		WWW_GQL_IDS,
 		FACEBOOK_GQL_IDS,
 		WAMO_GQL_IDS,