@violetix/baileys 0.0.0-stage → 0.3.18

package/lib/Socket/graphql.js

@@ -0,0 +1,908 @@
+
+import { Boom } from '@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(', ')
+		const code = json.errors[0]?.extensions?.error_code || 400
+		throw new Boom(`GraphQL error: ${msgs}`, { statusCode: code, data: json.errors[0] })
+	}
+	const response = dataPath ? json?.data?.[dataPath] : json?.data
+	if (response === undefined) {
+		throw new Boom('Unexpected GraphQL response structure', { statusCode: 400, data: json })
+	}
+	return response
+}
+
+/**
+ * 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)
+ */
+export 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, {
+		method: 'POST',
+		headers: { 'Content-Type': 'application/json' },
+		body
+	})
+	if (!res.ok) {
+		throw new Boom(`GraphQL HTTP error ${res.status}`, { statusCode: res.status })
+	}
+	const json = await res.json()
+	return parseGraphQLResponse(json, dataPath)
+}
+
+
+/**
+ * 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']
+ */
+export const executeFacebookGraphQL = (docId, variables, accessToken, dataPath = null, lang = 'en') =>
+	executeWWWGraphQL(docId, variables, accessToken, dataPath, lang, ENDPOINTS.ACS)
+
+
+/**
+ * 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)
+ */
+export const executeWamoGraphQL = async (docId, variables, wamoAuth = {}, dataPath = null, wamoHost = 'wamo.whatsapp.net') => {
+	const { accessToken = WWW_DEFAULT_TOKEN, credential = '', userId = '' } = wamoAuth
+	const params = new URLSearchParams({
+		access_token: accessToken,
+		credential,
+		user_id: String(userId),
+		app_id: WAMO_APP_ID,
+		doc_id: String(docId),
+		variables: JSON.stringify(variables)
+	})
+	const url = `https://${wamoHost}${ENDPOINTS.WAMO_PATH}`
+	const res = await fetch(url, {
+		method: 'POST',
+		headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+		body: params.toString()
+	})
+	if (!res.ok) {
+		throw new Boom(`Wamo GraphQL HTTP error ${res.status}`, { statusCode: res.status })
+	}
+	const json = await res.json()
+	return parseGraphQLResponse(json, dataPath)
+}
+
+
+// ── Wamo schema IDs (whatsapp-android-wamo_client_persist_ids.json) ──────────
+const WAMO_GQL_IDS = {
+	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', // 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',
+	AI_STUDIO_MEMORY_QUERY: '31947510941561276',
+	AI_CHARACTER_UPDATE_HIDE_STATUS: '9487449704689544',
+	AI_CREATION_CHECK_CREATED_BY_ME: '25141566425478200',
+	AI_CREATION_DELETE_PERSONA: '24692252033716044',
+	AI_CREATION_FETCH_CREATED_BOT: '25201089862855984',
+	AI_CREATION_FETCH_VOICE_SAMPLE: '25257088623922964',
+	AI_CREATION_UPDATE_PERSONA: '25011855005109940',
+	AI_CREATION_UPLOAD_IMAGE: '25003350059353070',
+	AI_HOME_FETCH_USER_CREATED_PERSONAS: '26593306827004416',
+	AI_HOME_SEARCH: '27216563884595110',
+	AI_SUBSCRIPTION_STATE: '36037182252547600',
+	AI_SUBSCRIPTION_USAGE_DATA: '25534888536186100',
+	META_AI_MEMORY_DELETE: '24675700195394532',
+	META_AI_MEMORY_DELETE_ALL: '25139336568989424',
+	META_AI_MEMORY_QUERY: '24926755306989290',
+	META_AI_UNIFIED_MEMORY_QUERY: '25207057475554616',
+	META_AI_VOICE_OPTIONS_FETCH: '25173439348954280',
+	META_AI_VOICE_OPTIONS_WITH_DEFAULT_FETCH: '32678535865070708',
+	META_AI_MEMORY_OPT_OUT_STATUS: '32233077506339604',
+	META_AI_MEMORY_OPT_OUT_UPDATE: '24192448100382070',
+	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',
+	IMAGINE_EXPAND: '27439000172356856',
+	IMAGINE_GENERATE_ANIMATE: '26556281783984270',
+	IMAGINE_INTENTS: '27226922903577250',
+	IMAGINE_ME_DELETE_ONBOARDING: '25412186125078290',
+	IMAGINE_ME_IS_ONBOARDED: '25177591448557896',
+	IMAGINE_ME_ONBOARDING: '33085607387721668',
+	IMAGINE_ME_ONBOARDING_WITH_VALIDATION: '33430299463235084',
+	IMAGINE_REPORT: '26056343243953412',
+	IMAGINE_SPOTLIGHT: '24814269768178584',
+	IMAGINE_VIDEO_STATUS: '34577682511875320',
+	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',
+	GET_EVENT: '26814174831581200',
+	GET_EVENT_LINK_PREVIEW: '26580394538296892',
+	GET_OR_CREATE_EVENT_INVITE_LINK: '26392982740362904',
+	LIST_EVENTS: '35283909937920624',
+	LIST_PRESET_COVER_IMAGES: '34976018872012652',
+	REMOVE_EVENT_INVITATIONS: '27723734560563308',
+	REMOVE_SELF_EVENT_INVITATION: '27063717026648636',
+	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',
+	BR_SAVE_CPF: '25491798377107610',
+	COMPLETE_PIX_TRANSACTION: '25561969973442564',
+	CREATE_ENROLLMENT: '34570903025891764',
+	GEN_CREATE_PAYMENT_KEY: '24662763616751130',
+	GEN_DELETE_PAYMENT_KEY: '25206218195637620',
+	GEN_SHARE_REMITTANCE_TRANSACTION_INTENT: '27219114284360650',
+	GEN_UPDATE_PAYMENT_KEY: '31853210500991230',
+	GET_BILL_COMPLAINT_URL: '33320245170908124',
+	GET_BILL_RECEIPT: '24825217813815704',
+	GET_BILLER_PLANS: '27309428811987468',
+	GET_ELIGIBILITY: '26212557348384404',
+	GET_ENROLLMENT_REGISTRATION_OPTIONS: '26215100541486172',
+	GET_MERCHANT_PIX_INFO: '32899184613062020',
+	GET_PAYMENT_KEY: '32245076985140016',
+	GET_PIX_BANK_LIST: '23883352801362930',
+	GET_REMITTANCE_TRANSACTION_DETAILS: '27062965096645132',
+	PAYMENT_HEALTH_CHECKS: '26301245572841100',
+	PAYMENT_REMINDER_CANCEL: '24755605054137416',
+	PAYMENT_REMINDER_CREATE: '26322317040760200',
+	PAYMENT_REMINDER_GET: '26644104721946830',
+	PAYMENT_REMINDER_STOP: '26813099368301640',
+	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',
+	GET_UPI_TOKEN: '25639185495767704',
+	UPI_ACCEPT_MANDATE: '26786867597629452',
+	UPI_CREATE_MANDATE: '26775212245448044',
+	UPI_EXECUTE_MANDATE: '26461549356828410',
+	UPI_PAUSE_MANDATE: '27067583129520630',
+	UPI_REJECT_MANDATE: '26669988755996836',
+	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',
+	WAMO_PROMO_ID_SET: '27944525051814324',
+	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',
+	WA_WEB_BIZ_CREATE_ORDER_JOB: '26504097415860764',
+	WA_WEB_BIZ_GRAPHQL_REFRESH_CART: '25888664220811280',
+	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',
+	GET_SUBSCRIPTIONS_AND_FEATURE_FLAGS: '26245030708467560',
+	REGISTER_ALL_ACCOUNTS: '33722449810701640',
+	REGISTER_INIT: '25224082377250600',
+	CHECK_DEVICE_REGISTRATION: '27544422375150964',
+	CANONICAL_ENT_QUERY_FEATURE: '24676915942008136',
+	CANONICAL_ENT_SETUP_FEATURE: '24192659730425376',
+	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',
+	CREATE_DOGFOODING_TASK: '26434237576236230',
+	CREATE_GROUP_SUSPENSION_APPEAL: '25646047815072530',
+	DELETE_USER_BILL_ACCOUNT: '24937622855831030',
+	EDIT_GEN_AI_TASK: '24357066917314970',
+	DELETE_GEN_AI_TASKS: '24358846127109424',
+	GET_SUBSCRIBED_TASKS_FOR_THREAD: '25301053199520772',
+	HATCH_CHANNEL_LINK: '27380458404880336',
+	HATCH_CHANNEL_METADATA: '36296584079940370',
+	LOG_SERVER_SENT_INVITE_INTENT: '26580640204871220',
+	OXYGEN_CHANNEL_OPT_IN: '32987565744221084',
+	OXYGEN_CHANNEL_OPT_OUT: '25230178203329240',
+	OXYGEN_CHANNEL_STATUS: '25600766796255944',
+	PASL_GET_LOGGER_CONFIG: '25514254748263110',
+	QUICK_PROMOTION_BATCH_FETCH: '27370264315996308',
+	SUBMIT_BUG_REPORT: '25907249708909480',
+	SUPPORT_CONTACT_FORM: '25272895205718040',
+	UNIFIED_CONVERSATION_STARTERS: '34344055808526010',
+	WA_GIZMO_POST_METADATA: '26390610653941050',
+	WA_QUICK_PROMOTION_LOG: '24712276558462964',
+	WA_SUPPORT_MESSAGE_FEEDBACK: '25850332711237184',
+	GET_AI_PREDICTED_AGE: '34158896507030940',
+	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',
+	DROP_IN_IMAGINE_GENERATE: '34481380128115810',
+	FB_MEMU_PERMISSION_QUERY: '26457099770583124',
+	FETCH_META_AI_MODES: '24685093691140660',
+	GEN_AI_EDIT_ANIMATE: '26618842254369468',
+	GEN_AI_EDIT_BACKDROP_SUGGESTIONS: '6884142735042929',
+	GEN_AI_EDIT_IMAGE_BACKDROP: '24768153272860376',
+	GEN_AI_EDIT_SUGGESTIONS: '27713400524973656',
+	GEN_AI_EDIT_UPLOAD_AUTHENTIC_IMAGE: '8289643261132632',
+	GEN_AI_IMAGINE_BULK_SEND_MEDIA_TO_CHAT: '9621096711262312',
+	GEN_AI_IMAGINE_CANVAS_API: '26120441040992056',
+	GEN_AI_IMAGINE_DOWNLOAD_MEDIA: '34879204598389744',
+	GEN_AI_IMAGINE_EDIT: '26723939223901400',
+	GEN_AI_IMAGINE_GENERATE_FLASH: '25517143427978588',
+	GEN_AI_IMAGINE_GENERATE_FROM_IMAGE: '26234794616158744',
+	GEN_AI_IMAGINE_GENERATE: '25754106557586292',
+	GEN_AI_IMAGINE_GENERATE_STREAMING: '26021242964174344',
+	GEN_AI_IMAGINE_HAS_MEMU_PROFILE: '25660710533526260',
+	GEN_AI_IMAGINE_INSPIRATION_CANVAS_API: '26630710513263730',
+	GEN_AI_IMAGINE_PROMPT_SUMMARIZATION: '8356011394456431',
+	GEN_AI_IMAGINE_REGENERATE: '25723954363936656',
+	GEN_AI_IMAGINE_RESTYLE_SECTIONS: '30782654914682896',
+	GEN_AI_IMAGINE_SEND_MEDIA_TO_CHAT: '9040988989304072',
+	GEN_AI_IMAGINE_SUGGESTIONS: '26477038211947360',
+	GEN_AI_IMAGINE_UPDATE_MEMU_PROFILE_PERMISSION: '24987386417587030',
+	GEN_AI_MEMU_UPDATE_VOICE: '25208555012114170',
+	GEN_AI_SOCIAL_ENTITY_DETAILS: '27413840814867420',
+	GEN_AI_VERIFY_MEMU_PHOTOS: '30310486848564932',
+	GET_MEMU_STICKER_BY_ID: '8894972063896486',
+	MAI_UNIFIED_USER: '24664034623258600',
+	MAI_UNIFIED_USER_QUERY: '24774891068876300',
+	MAI_UNIFIED_USER_RESET: '26233658572900960',
+	MEMU_PREVIEW_PHOTO: '7416457868478773',
+	MEMU_PROFILE_QUERY: '25494748856799176',
+	MEMU_UPDATE_PROFILE: '8634007059959370',
+	META_AI_FEEDBACK: '24461110943539464',
+	META_AI_INTENT_CARD_NUX_ELIGIBILITY_RESET: '7906012969525854',
+	META_AI_INTENT_CARD_NUX_IMPRESSION: '29146653178312916',
+	META_AI_INTENT_CARD_NUX_IMPRESSION_QUERY: '7397847270321576',
+	META_AI_MODES_QUERY: '9990098797780674',
+	META_AI_RICH_PLACE_DETAILS: '26652957641066240',
+	META_AI_SIDE_BY_SIDE_SURVEY_RESPONSE: '23972248465795460',
+	META_AI_STOP_GENERATION: '25449755391321784',
+	META_AI_BIZ_AGENT_VOICE_ATTACHMENTS: '32359943033604852',
+	META_AI_CUSTOMIZATION_GEN_AI_SET_MODE: '31825632867051630',
+	SIMPLE_ECHO: '8800911093353750',
+	UPDATE_MEMU_SELFIE: '26374541155506570'
+}
+
+export const makeGraphQLSocket = sock => {
+	let _accessToken = null
+	let _tokenPromise = null
+	let _wamoAuth = {}
+	let _wamoHost = 'wamo.whatsapp.net'
+
+	const setAccessToken = token => {
+		_accessToken = token
+		_tokenPromise = null
+	}
+
+	const setWamoAuth = (auth, host = null) => {
+		_wamoAuth = auth
+		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
+		const pending = (async () => {
+			const nonceData = await sock.wwwGetNonce()
+			const nonce = nonceData?.nonce ?? nonceData
+			const tokenData = await sock.wwwExchangeNonce(nonce)
+			const token = tokenData?.access_token ?? tokenData
+			if (_tokenPromise === pending) _accessToken = token
+			return token
+		})()
+		_tokenPromise = pending
+		const clearPending = () => {
+			if (_tokenPromise === pending) _tokenPromise = null
+		}
+		pending.then(clearPending, clearPending)
+		return _tokenPromise
+	}
+
+	const www = async (docId, variables, dataPath = null) => {
+		const token = await acquireAccessToken()
+		return executeWWWGraphQL(docId, variables, token, dataPath)
+	}
+
+	const fb = async (docId, variables, dataPath = null) => {
+		const token = await acquireAccessToken()
+		return executeFacebookGraphQL(docId, variables, token, dataPath)
+	}
+
+	const wamo = (docId, variables, dataPath = null) =>
+		executeWamoGraphQL(docId, variables, _wamoAuth, dataPath, _wamoHost)
+
+	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'),
+		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'),
+		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'),
+		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'),
+		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'),
+		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'),
+
+		// ── 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'
+			),
+		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'),
+		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'),
+		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'),
+		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'),
+
+		// ── 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'),
+		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'),
+		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'),
+		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'),
+		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'),
+
+		// ── 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'),
+		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'),
+		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'),
+
+		// ── 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'),
+		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'
+			),
+		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'),
+		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'),
+		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'),
+		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'),
+
+		// ── 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'),
+		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'),
+
+		// ── 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'),
+		wamoLinkUser: input => wamo(WAMO_GQL_IDS.LINK_USER, { input }, 'xwa2_wamo_link_user'),
+		wamoHeartbeat: () => wamo(WAMO_GQL_IDS.HEARTBEAT, {}, 'xwa2_wamo_heartbeat'),
+		wamoHidePage: pageId => wamo(WAMO_GQL_IDS.HIDE_PAGE, { page_id: pageId }, 'xwa2_wamo_hide_page'),
+		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'),
+		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'),
+
+		// ── Meta AI feedback / control (client-persist) ──────────────────────
+		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),
+
+		// ── MAI Unified User (client-persist) ────────────────────────────────
+		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),
+
+		// ── MEMU avatar/persona (client-persist) ─────────────────────────────
+		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),
+
+		// ── GenAI Imagine (client-persist) ───────────────────────────────────
+		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),
+
+		// ── GenAI Edit (client-persist) ───────────────────────────────────────
+		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),
+
+		// ── Immersive creation (client-persist) ──────────────────────────────
+		immersiveCreationComplete: input => www(WWW_GQL_IDS.IMMERSIVE_CREATION_COMPLETE, { input }, null),
+		immersiveCreationConfig: () => www(WWW_GQL_IDS.IMMERSIVE_CREATION_CONFIG, {}, null),
+
+		// ── Misc client-persist ───────────────────────────────────────────────
+		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,
+		CLIENT_PERSIST_GQL_IDS,
+		ENDPOINTS
+	}
+}
+