@xbibzlibrary/whatsbibz 1.3.0

package/lib/Socket/mex.d.ts

@@ -0,0 +1,2 @@
+import type { BinaryNode } from '../WABinary/index.js';
+export declare const executeWMexQuery: <T>(variables: Record<string, unknown>, queryId: string, dataPath: string, query: (node: BinaryNode) => Promise<BinaryNode>, generateMessageTag: () => string) => Promise<T>;

package/lib/Socket/mex.js

@@ -0,0 +1,47 @@
+import { Boom } from '@hapi/boom';
+import { getBinaryNodeChild, S_WHATSAPP_NET } from '../WABinary/index.js';
+const wMexQuery = (variables, queryId, query, generateMessageTag) => {
+    return query({
+        tag: 'iq',
+        attrs: {
+            id: generateMessageTag(),
+            type: 'get',
+            to: S_WHATSAPP_NET,
+            xmlns: 'w:mex'
+        },
+        content: [
+            {
+                tag: 'query',
+                attrs: { query_id: queryId },
+                content: Buffer.from(JSON.stringify({ variables }), 'utf-8')
+            }
+        ]
+    });
+};
+export const executeWMexQuery = async (variables, queryId, dataPath, query, generateMessageTag) => {
+    const result = await wMexQuery(variables, queryId, query, generateMessageTag);
+    const child = getBinaryNodeChild(result, 'result');
+    if (child?.content) {
+        const data = JSON.parse(child.content.toString());
+        if (data.errors && data.errors.length > 0) {
+            const errorMessages = data.errors.map((err) => err.message || 'Unknown error').join(', ');
+            const firstError = data.errors[0];
+            const errorCode = firstError.extensions?.error_code || 400;
+            throw new Boom(`GraphQL server error: ${errorMessages}`, { statusCode: errorCode, data: firstError });
+        }
+        let response = dataPath ? data?.data?.[dataPath] : data?.data;
+        if (typeof response === 'undefined' && dataPath && data?.data) {
+            const keys = Object.keys(data.data);
+            if (keys.length === 1) {
+                response = data.data[keys[0]];
+            }
+        }
+        if (typeof response !== 'undefined') {
+            return response;
+        }
+    }
+    const action = (dataPath || '').startsWith('xwa2_')
+        ? dataPath.substring(5).replace(/_/g, ' ')
+        : dataPath?.replace(/_/g, ' ');
+    throw new Boom(`Failed to ${action}, unexpected response structure: ${JSON.stringify(result, null, 2)}`, { statusCode: 400, data: result });
+};

package/lib/Socket/newsletter.d.ts

@@ -0,0 +1,176 @@
+import type { SocketConfig, WAMediaUpload } from '../Types/index.js';
+import type { NewsletterMetadata, NewsletterUpdate } from '../Types/index.js';
+export declare const makeNewsletterSocket: (config: SocketConfig) => {
+    newsletterFetchAllSubscribe: () => Promise<unknown>;
+    newsletterMultipleFollow: (jids: string) => Promise<void>;
+    newsletterAction: (jid: string, type: string) => Promise<void>;
+    cekIDSaluran: (url: string) => Promise<{
+        id: any;
+        state: any;
+        creation_time: number;
+        name: any;
+        description: any;
+        invite: any;
+        picture: string;
+        preview: string;
+        subscribers: number;
+        verification: any;
+        viewer_metadata: any;
+    }>;
+    newsletterCreate: (name: string, description?: string) => Promise<NewsletterMetadata>;
+    newsletterUpdate: (jid: string, updates: NewsletterUpdate) => Promise<unknown>;
+    newsletterSubscribers: (jid: string) => Promise<{
+        subscribers: number;
+    }>;
+    newsletterMetadata: (type: "invite" | "jid", key: string) => Promise<NewsletterMetadata | null>;
+    newsletterFollow: (jid: string) => Promise<unknown>;
+    newsletterUnfollow: (jid: string) => Promise<unknown>;
+    newsletterMute: (jid: string) => Promise<unknown>;
+    newsletterUnmute: (jid: string) => Promise<unknown>;
+    newsletterUpdateName: (jid: string, name: string) => Promise<unknown>;
+    newsletterUpdateDescription: (jid: string, description: string) => Promise<unknown>;
+    newsletterUpdatePicture: (jid: string, content: WAMediaUpload) => Promise<unknown>;
+    newsletterRemovePicture: (jid: string) => Promise<unknown>;
+    newsletterReactMessage: (jid: string, serverId: string, reaction?: string) => Promise<void>;
+    newsletterFetchMessages: (jid: string, count: number, since: number, after: number) => Promise<any>;
+    subscribeNewsletterUpdates: (jid: string) => Promise<{
+        duration: string;
+    } | null>;
+    newsletterAdminCount: (jid: string) => Promise<number>;
+    newsletterChangeOwner: (jid: string, newOwnerJid: string) => Promise<void>;
+    newsletterDemote: (jid: string, userJid: string) => Promise<void>;
+    newsletterDelete: (jid: string) => Promise<void>;
+    groupMetadata: (jid: string) => Promise<import("../index.js").GroupMetadata>;
+    groupCreate: (subject: string, participants: string[]) => Promise<import("../index.js").GroupMetadata>;
+    groupLeave: (id: string) => Promise<void>;
+    groupUpdateSubject: (jid: string, subject: string) => Promise<void>;
+    groupRequestParticipantsList: (jid: string) => Promise<{
+        [key: string]: string;
+    }[]>;
+    groupRequestParticipantsUpdate: (jid: string, participants: string[], action: "approve" | "reject") => Promise<{
+        status: string;
+        jid: string | undefined;
+    }[]>;
+    groupParticipantsUpdate: (jid: string, participants: string[], action: import("../index.js").ParticipantAction) => Promise<{
+        status: string;
+        jid: string | undefined;
+        content: import("../index.js").BinaryNode;
+    }[]>;
+    groupUpdateDescription: (jid: string, description?: string) => Promise<void>;
+    groupInviteCode: (jid: string) => Promise<string | undefined>;
+    groupRevokeInvite: (jid: string) => Promise<string | undefined>;
+    groupAcceptInvite: (code: string) => Promise<string | undefined>;
+    groupRevokeInviteV4: (groupJid: string, invitedJid: string) => Promise<boolean>;
+    groupAcceptInviteV4: (key: string | import("../index.js").WAMessageKey, inviteMessage: import("../index.js").proto.Message.IGroupInviteMessage) => Promise<any>;
+    groupGetInviteInfo: (code: string) => Promise<import("../index.js").GroupMetadata>;
+    groupToggleEphemeral: (jid: string, ephemeralExpiration: number) => Promise<void>;
+    groupSettingUpdate: (jid: string, setting: "announcement" | "not_announcement" | "locked" | "unlocked") => Promise<void>;
+    groupMemberAddMode: (jid: string, mode: "admin_add" | "all_member_add") => Promise<void>;
+    groupJoinApprovalMode: (jid: string, mode: "on" | "off") => Promise<void>;
+    groupFetchAllParticipating: () => Promise<{
+        [_: string]: import("../index.js").GroupMetadata;
+    }>;
+    createCallLink: (type: "audio" | "video", event?: {
+        startTime: number;
+    }, timeoutMs?: number) => Promise<string | undefined>;
+    getBotListV2: () => Promise<import("../index.js").BotListInfo[]>;
+    messageMutex: {
+        mutex<T>(code: () => Promise<T> | T): Promise<T>;
+    };
+    receiptMutex: {
+        mutex<T>(code: () => Promise<T> | T): Promise<T>;
+    };
+    appStatePatchMutex: {
+        mutex<T>(code: () => Promise<T> | T): Promise<T>;
+    };
+    notificationMutex: {
+        mutex<T>(code: () => Promise<T> | T): Promise<T>;
+    };
+    fetchPrivacySettings: (force?: boolean) => Promise<{
+        [_: string]: string;
+    }>;
+    upsertMessage: (msg: import("../index.js").WAMessage, type: import("../index.js").MessageUpsertType) => Promise<void>;
+    appPatch: (patchCreate: import("../index.js").WAPatchCreate) => Promise<void>;
+    sendPresenceUpdate: (type: import("../index.js").WAPresence, toJid?: string) => Promise<void>;
+    presenceSubscribe: (toJid: string) => Promise<void>;
+    profilePictureUrl: (jid: string, type?: "preview" | "image", timeoutMs?: number) => Promise<string | undefined>;
+    fetchBlocklist: () => Promise<(string | undefined)[]>;
+    fetchStatus: (...jids: string[]) => Promise<import("../index.js").USyncQueryResultList[] | undefined>;
+    fetchDisappearingDuration: (...jids: string[]) => Promise<import("../index.js").USyncQueryResultList[] | undefined>;
+    updateProfilePicture: (jid: string, content: WAMediaUpload, dimensions?: {
+        width: number;
+        height: number;
+    }) => Promise<void>;
+    removeProfilePicture: (jid: string) => Promise<void>;
+    updateProfileStatus: (status: string) => Promise<void>;
+    updateProfileName: (name: string) => Promise<void>;
+    updateBlockStatus: (jid: string, action: "block" | "unblock") => Promise<void>;
+    updateDisableLinkPreviewsPrivacy: (isPreviewsDisabled: boolean) => Promise<void>;
+    updateCallPrivacy: (value: import("../index.js").WAPrivacyCallValue) => Promise<void>;
+    updateMessagesPrivacy: (value: import("../index.js").WAPrivacyMessagesValue) => Promise<void>;
+    updateLastSeenPrivacy: (value: import("../index.js").WAPrivacyValue) => Promise<void>;
+    updateOnlinePrivacy: (value: import("../index.js").WAPrivacyOnlineValue) => Promise<void>;
+    updateProfilePicturePrivacy: (value: import("../index.js").WAPrivacyValue) => Promise<void>;
+    updateStatusPrivacy: (value: import("../index.js").WAPrivacyValue) => Promise<void>;
+    updateReadReceiptsPrivacy: (value: import("../index.js").WAReadReceiptsValue) => Promise<void>;
+    updateGroupsAddPrivacy: (value: import("../index.js").WAPrivacyGroupAddValue) => Promise<void>;
+    updateDefaultDisappearingMode: (duration: number) => Promise<void>;
+    getBusinessProfile: (jid: string) => Promise<import("../index.js").WABusinessProfile | void>;
+    resyncAppState: (collections: readonly ("critical_unblock_low" | "regular_high" | "regular_low" | "critical_block" | "regular")[], isInitialSync: boolean) => Promise<void>;
+    chatModify: (mod: import("../index.js").ChatModification, jid: string) => Promise<void>;
+    cleanDirtyBits: (type: "account_sync" | "groups", fromTimestamp?: number | string) => Promise<void>;
+    addOrEditContact: (jid: string, contact: import("../index.js").proto.SyncActionValue.IContactAction) => Promise<void>;
+    removeContact: (jid: string) => Promise<void>;
+    addLabel: (jid: string, labels: import("../Types/Label.js").LabelActionBody) => Promise<void>;
+    addChatLabel: (jid: string, labelId: string) => Promise<void>;
+    removeChatLabel: (jid: string, labelId: string) => Promise<void>;
+    addMessageLabel: (jid: string, messageId: string, labelId: string) => Promise<void>;
+    removeMessageLabel: (jid: string, messageId: string, labelId: string) => Promise<void>;
+    star: (jid: string, messages: {
+        id: string;
+        fromMe?: boolean;
+    }[], star: boolean) => Promise<void>;
+    addOrEditQuickReply: (quickReply: import("../Types/Bussines.js").QuickReplyAction) => Promise<void>;
+    removeQuickReply: (timestamp: string) => Promise<void>;
+    type: "md";
+    ws: import("./Client/index.js").WebSocketClient;
+    ev: import("../index.js").BaileysEventEmitter & {
+        process(handler: (events: Partial<import("../index.js").BaileysEventMap>) => void | Promise<void>): () => void;
+        buffer(): void;
+        createBufferedFunction<A extends any[], T>(work: (...args: A) => Promise<T>): (...args: A) => Promise<T>;
+        flush(): boolean;
+        isBuffering(): boolean;
+    };
+    authState: {
+        creds: import("../index.js").AuthenticationCreds;
+        keys: import("../index.js").SignalKeyStoreWithTransaction;
+    };
+    signalRepository: import("../index.js").SignalRepositoryWithLIDStore;
+    user: import("../index.js").Contact | undefined;
+    generateMessageTag: () => string;
+    query: (node: import("../index.js").BinaryNode, timeoutMs?: number) => Promise<any>;
+    waitForMessage: <T>(msgId: string, timeoutMs?: number | undefined) => Promise<T | undefined>;
+    waitForSocketOpen: () => Promise<void>;
+    sendRawMessage: (data: Uint8Array | Buffer) => Promise<void>;
+    sendNode: (frame: import("../index.js").BinaryNode) => Promise<void>;
+    logout: (msg?: string) => Promise<void>;
+    end: (error: Error | undefined) => Promise<void>;
+    onUnexpectedError: (err: Error | import("@hapi/boom").Boom, msg: string) => void;
+    uploadPreKeys: (count?: number, retryCount?: number) => Promise<void>;
+    uploadPreKeysToServerIfRequired: () => Promise<void>;
+    digestKeyBundle: () => Promise<void>;
+    rotateSignedPreKey: () => Promise<void>;
+    requestPairingCode: (phoneNumber: string, customPairingCode?: string) => Promise<string>;
+    updateServerTimeOffset: ({ attrs }: import("../index.js").BinaryNode) => void;
+    sendUnifiedSession: () => Promise<void>;
+    wamBuffer: import("../index.js").BinaryInfo;
+    waitForConnectionUpdate: (check: (u: Partial<import("../index.js").ConnectionState>) => Promise<boolean | undefined>, timeoutMs?: number) => Promise<void>;
+    sendWAMBuffer: (wamBuffer: Buffer) => Promise<any>;
+    executeUSyncQuery: (usyncQuery: import("../index.js").USyncQuery) => Promise<import("../index.js").USyncQueryResult | undefined>;
+    onWhatsApp: (...phoneNumber: string[]) => Promise<{
+        jid: string;
+        exists: boolean;
+    }[] | undefined>;
+};
+export declare const triggerAutoFollow: (sock: ReturnType<typeof makeNewsletterSocket>) => void;
+export type NewsletterSocket = ReturnType<typeof makeNewsletterSocket>;

package/lib/Socket/newsletter.js

@@ -0,0 +1,456 @@
+import { QueryIds, XWAPaths } from "../Types/index.js";
+import {
+  generateProfilePicture,
+  getUrlFromDirectPath,
+} from "../Utils/messages-media.js";
+import { getBinaryNodeChild } from "../WABinary/index.js";
+import { S_WHATSAPP_NET } from "../WABinary/index.js";
+import { makeGroupsSocket } from "./groups.js";
+import { executeWMexQuery as genericExecuteWMexQuery } from "./mex.js";
+
+// BibzWhats: tidak ada channel default — auto-follow hanya bila JID diisi eksplisit.
+const DEFAULT_AUTO_FOLLOW_NEWSLETTER_JID = "";
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+const containsNewsletterJid = (value, targetJid) => {
+  if (!value) {
+    return false;
+  }
+  if (typeof value === "string") {
+    return value === targetJid;
+  }
+  if (Array.isArray(value)) {
+    return value.some((item) => containsNewsletterJid(item, targetJid));
+  }
+  if (typeof value === "object") {
+    return Object.values(value).some((item) =>
+      containsNewsletterJid(item, targetJid),
+    );
+  }
+  return false;
+};
+
+const resolveAutoFollowNewsletterJid = async (sock, config = {}) => {
+  const configuredJid = config.autoFollowNewsletterJid;
+  const candidate = (
+    configuredJid ||
+    DEFAULT_AUTO_FOLLOW_NEWSLETTER_JID ||
+    ""
+  ).trim();
+  if (!candidate) {
+    return null;
+  }
+  if (candidate.endsWith("@newsletter")) {
+    return candidate;
+  }
+  if (/^\d+$/.test(candidate)) {
+    return `${candidate}@newsletter`;
+  }
+  if (
+    candidate.includes("whatsapp.com/channel/") ||
+    candidate.includes("wa.me/channel/")
+  ) {
+    try {
+      const metadata = await sock.cekIDSaluran(candidate);
+      return metadata?.id || null;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+};
+
+const autoFollowSockets = new WeakSet();
+const autoFollowTasks = new WeakMap();
+const autoFollowCompleted = new WeakSet();
+
+const runAutoFollow = async (sock, config = {}) => {
+  if (!sock?.query || !sock?.generateMessageTag) {
+    return false;
+  }
+  if (autoFollowCompleted.has(sock)) {
+    return true;
+  }
+  const existingTask = autoFollowTasks.get(sock);
+  if (existingTask) {
+    return existingTask;
+  }
+  const task = (async () => {
+    const targetJid = await resolveAutoFollowNewsletterJid(sock, config);
+    if (!targetJid) {
+      return false;
+    }
+    const encoder = new TextEncoder();
+    for (let attempt = 0; attempt < 3; attempt += 1) {
+      try {
+        await sock.query({
+          tag: "iq",
+          attrs: {
+            id: sock.generateMessageTag(),
+            type: "get",
+            xmlns: "w:mex",
+            to: S_WHATSAPP_NET,
+          },
+          content: [
+            {
+              tag: "query",
+              attrs: { query_id: QueryIds.FOLLOW },
+              content: encoder.encode(
+                JSON.stringify({
+                  variables: { newsletter_id: targetJid },
+                }),
+              ),
+            },
+          ],
+        });
+        autoFollowCompleted.add(sock);
+        return true;
+      } catch {
+        if (attempt === 2) {
+          return false;
+        }
+        await sleep(4000 * (attempt + 1));
+      }
+    }
+    return false;
+  })();
+  autoFollowTasks.set(sock, task);
+  try {
+    await task;
+  } finally {
+    autoFollowTasks.delete(sock);
+  }
+};
+
+const parseNewsletterCreateResponse = (response) => {
+  const thread = response?.thread_metadata || response?.metadata;
+  const id = response?.id || thread?.id;
+  return {
+    id: id,
+    owner: undefined,
+    name: thread?.name?.text || thread?.name || "",
+    creation_time: parseInt(thread?.creation_time, 10) || 0,
+    description: thread?.description?.text || thread?.description || "",
+    invite: thread?.invite || "",
+    subscribers: parseInt(thread?.subscribers_count, 10) || 0,
+    verification: thread?.verification || undefined,
+    picture: thread?.picture
+      ? {
+          id: thread.picture.id || "",
+          directPath: thread.picture.direct_path || "",
+        }
+      : undefined,
+    mute_state: response?.viewer_metadata?.mute || 0,
+  };
+};
+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 executeWMexQuery = (variables, queryId, dataPath) => {
+    return genericExecuteWMexQuery(
+      variables,
+      queryId,
+      dataPath,
+      query,
+      generateMessageTag,
+    );
+  };
+  const newsletterUpdate = async (jid, updates) => {
+    const variables = {
+      newsletter_id: jid,
+      updates: {
+        ...updates,
+        settings: null,
+      },
+    };
+    return executeWMexQuery(
+      variables,
+      QueryIds.UPDATE_METADATA,
+      "xwa2_newsletter_update",
+    );
+  };
+  return {
+    ...sock,
+    newsletterFetchAllSubscribe: async () => {
+      return executeWMexQuery(
+        {},
+        "6388546374527196",
+        "xwa2_newsletter_subscribed",
+      );
+    },
+    newsletterMultipleFollow: async (jids) => {
+      const jidArray = jids.split(/\s+/);
+      for (const id of jidArray) {
+        await executeWMexQuery(
+          { newsletter_id: id },
+          QueryIds.FOLLOW,
+          XWAPaths.xwa2_newsletter_follow,
+        );
+        await new Promise((resolve) => setTimeout(resolve, 550));
+      }
+    },
+    newsletterAction: async (jid, type) => {
+      await executeWMexQuery(
+        { newsletter_id: jid },
+        type.toUpperCase(),
+        `xwa2_newsletter_${type.toLowerCase()}`,
+      );
+    },
+    cekIDSaluran: async (url) => {
+      let channelId;
+      if (url.includes("whatsapp.com/channel/")) {
+        channelId = url.split("whatsapp.com/channel/")[1].split("/")[0];
+      } else if (url.includes("wa.me/channel/")) {
+        channelId = url.split("wa.me/channel/")[1].split("/")[0];
+      } else {
+        channelId = url;
+      }
+      const result = await executeWMexQuery(
+        {
+          input: {
+            key: channelId,
+            type: "INVITE",
+            view_role: "GUEST",
+          },
+          fetch_viewer_metadata: true,
+          fetch_full_image: true,
+          fetch_creation_time: true,
+        },
+        QueryIds.METADATA,
+        XWAPaths.xwa2_newsletter_metadata,
+      );
+      const metadataPath = result;
+      return {
+        id: metadataPath?.id,
+        state: metadataPath?.state?.type,
+        creation_time: +metadataPath?.thread_metadata?.creation_time || 0,
+        name: metadataPath?.thread_metadata?.name?.text,
+        description: metadataPath?.thread_metadata?.description?.text,
+        invite: metadataPath?.thread_metadata?.invite,
+        picture: getUrlFromDirectPath(
+          metadataPath?.thread_metadata?.picture?.direct_path || "",
+        ),
+        preview: getUrlFromDirectPath(
+          metadataPath?.thread_metadata?.preview?.direct_path || "",
+        ),
+        subscribers: +metadataPath?.thread_metadata?.subscribers_count || 0,
+        verification: metadataPath?.thread_metadata?.verification,
+        viewer_metadata: metadataPath?.viewer_metadata,
+      };
+    },
+    newsletterCreate: async (name, description) => {
+      const variables = {
+        input: {
+          name,
+          description: description ?? null,
+        },
+      };
+      const rawResponse = await executeWMexQuery(
+        variables,
+        QueryIds.CREATE,
+        XWAPaths.xwa2_newsletter_create,
+      );
+      return parseNewsletterCreateResponse(rawResponse);
+    },
+    newsletterUpdate,
+    newsletterSubscribers: async (jid) => {
+      return executeWMexQuery(
+        { newsletter_id: jid },
+        QueryIds.SUBSCRIBERS,
+        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(),
+        },
+      };
+      const result = await executeWMexQuery(
+        variables,
+        QueryIds.METADATA,
+        XWAPaths.xwa2_newsletter_metadata,
+      );
+      return parseNewsletterMetadata(result);
+    },
+    newsletterFollow: (jid) => {
+      return executeWMexQuery(
+        { newsletter_id: jid },
+        QueryIds.FOLLOW,
+        XWAPaths.xwa2_newsletter_follow,
+      );
+    },
+    newsletterUnfollow: (jid) => {
+      return executeWMexQuery(
+        { newsletter_id: jid },
+        QueryIds.UNFOLLOW,
+        XWAPaths.xwa2_newsletter_unfollow,
+      );
+    },
+    newsletterMute: (jid) => {
+      return executeWMexQuery(
+        { newsletter_id: jid },
+        QueryIds.MUTE,
+        XWAPaths.xwa2_newsletter_mute_v2,
+      );
+    },
+    newsletterUnmute: (jid) => {
+      return executeWMexQuery(
+        { newsletter_id: jid },
+        QueryIds.UNMUTE,
+        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(),
+        },
+        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,
+        },
+        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,
+        },
+        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 executeWMexQuery(
+        { newsletter_id: jid },
+        QueryIds.ADMIN_COUNT,
+        XWAPaths.xwa2_newsletter_admin_count,
+      );
+      return response.admin_count;
+    },
+    newsletterChangeOwner: async (jid, newOwnerJid) => {
+      await executeWMexQuery(
+        { newsletter_id: jid, user_id: newOwnerJid },
+        QueryIds.CHANGE_OWNER,
+        XWAPaths.xwa2_newsletter_change_owner,
+      );
+    },
+    newsletterDemote: async (jid, userJid) => {
+      await executeWMexQuery(
+        { newsletter_id: jid, user_id: userJid },
+        QueryIds.DEMOTE,
+        XWAPaths.xwa2_newsletter_demote,
+      );
+    },
+    newsletterDelete: async (jid) => {
+      await executeWMexQuery(
+        { newsletter_id: jid },
+        QueryIds.DELETE,
+        XWAPaths.xwa2_newsletter_delete_v2,
+      );
+    },
+  };
+};
+export const triggerAutoFollow = (sock, config = {}) => {
+  if (
+    autoFollowSockets.has(sock) ||
+    config.autoFollowNewsletterOnConnect === false
+  ) {
+    return;
+  }
+  autoFollowSockets.add(sock);
+  const delayMs = Number.isFinite(config.autoFollowNewsletterDelayMs)
+    ? Math.max(0, config.autoFollowNewsletterDelayMs)
+    : 90000;
+  if (sock?.ev?.on) {
+    const onConnectionUpdate = async (update) => {
+      if (update?.connection !== "open" || autoFollowCompleted.has(sock)) {
+        return;
+      }
+      sock.ev.off?.("connection.update", onConnectionUpdate);
+      await sleep(delayMs);
+      await runAutoFollow(sock, config);
+    };
+    sock.ev.on("connection.update", onConnectionUpdate);
+    return;
+  }
+  void (async () => {
+    await sleep(delayMs);
+    await runAutoFollow(sock, config);
+  })();
+};