zapo-js 0.3.0 → 1.0.0

package/dist/esm/transport/binary/tokens.js

@@ -3,7 +3,7 @@
  * Source: WAWeb deobfuscated WAWapDict.js
  */
 export const DICT_VERSION = 3;
-export const SINGLE_BYTE_TOKENS = [
+export const SINGLE_BYTE_TOKENS = Object.freeze([
     'xmlstreamstart',
     'xmlstreamend',
     's.whatsapp.net',
@@ -239,8 +239,8 @@ export const SINGLE_BYTE_TOKENS = [
     '1080',
     '03',
     'screen_height'
-];
-export const DICTIONARY_0_TOKENS = [
+]);
+export const DICTIONARY_0_TOKENS = Object.freeze([
     'read-self',
     'active',
     'fbns',
@@ -497,8 +497,8 @@ export const DICTIONARY_0_TOKENS = [
     'catalog_exists',
     '01f',
     'mute_v2'
-];
-export const DICTIONARY_1_TOKENS = [
+]);
+export const DICTIONARY_1_TOKENS = Object.freeze([
     'reject',
     'dirty',
     'announcement',
@@ -755,8 +755,8 @@ export const DICTIONARY_1_TOKENS = [
     'web_md_migration_experience',
     'ptt_conversation_waveform',
     'u_aud_limit_sil_restarts_test1'
-];
-export const DICTIONARY_2_TOKENS = [
+]);
+export const DICTIONARY_2_TOKENS = Object.freeze([
     '64',
     'ptt_playback_speed_enabled',
     'web_product_list_message_enabled',
@@ -1013,8 +1013,8 @@ export const DICTIONARY_2_TOKENS = [
     '1213',
     '1304',
     '1537'
-];
-export const DICTIONARY_3_TOKENS = [
+]);
+export const DICTIONARY_3_TOKENS = Object.freeze([
     '1724',
     'profile_picture',
     '1071',
@@ -1271,10 +1271,10 @@ export const DICTIONARY_3_TOKENS = [
     '1147',
     '1372',
     '1961'
-];
-export const DICTIONARIES = [
+]);
+export const DICTIONARIES = Object.freeze([
     DICTIONARY_0_TOKENS,
     DICTIONARY_1_TOKENS,
     DICTIONARY_2_TOKENS,
     DICTIONARY_3_TOKENS
-];
+]);

package/dist/esm/transport/index.js

@@ -1,5 +1,6 @@
 export { decodeBinaryNode, decodeBinaryNodeStanza, encodeBinaryNode, encodeBinaryNodeStanza } from './binary/index.js';
 export { isProxyAgent, isProxyDispatcher, isProxyTransport, toProxyAgent, toProxyDispatcher } from './proxy.js';
+export { fetchLatestWaWebVersion } from './wa-web-version-fetcher.js';
 export { WaComms } from './WaComms.js';
 export { verifyNoiseCertificateChain } from './noise/WaNoiseCert.js';
 export { WaNoiseHandshake } from './noise/WaNoiseHandshake.js';

package/dist/esm/transport/keepalive/WaKeepAlive.js

@@ -3,6 +3,11 @@ import { normalizeNonNegativeInteger, toError } from '../../util/primitives.js';
 const KEEPALIVE_DEFAULT_JITTER_RATIO = 0.1;
 const KEEPALIVE_DEFAULT_MIN_JITTER_MS = 250;
 const KEEPALIVE_MAX_JITTER_RATIO = 0.5;
+/**
+ * Periodically pings the server with a ping IQ to detect dead sockets and
+ * measure clock skew. Skips when the orchestrator has other traffic in
+ * flight; recovers a queued/dropped ping via the configured `getComms()`.
+ */
 export class WaKeepAlive {
     constructor(options) {
         this.logger = options.logger;
@@ -14,6 +19,7 @@ export class WaKeepAlive {
         this.hostDomain = options.hostDomain ?? WA_DEFAULTS.HOST_DOMAIN;
         this.jitterRatio = this.normalizeJitterRatio(options.jitterRatio);
         this.minJitterMs = normalizeNonNegativeInteger(options.minJitterMs, KEEPALIVE_DEFAULT_MIN_JITTER_MS);
+        this.onClockSkewMs = options.onClockSkewMs;
         this.timer = null;
         this.generation = 0;
         this.inFlight = false;
@@ -81,10 +87,18 @@ export class WaKeepAlive {
                     xmlns: WA_XMLNS.WHATSAPP_PING
                 }
             };
-            await this.nodeOrchestrator.query(pingNode, this.timeoutMs);
-            this.logger.debug('keepalive ping success', {
-                latencyMs: Date.now() - startedAt
-            });
+            const response = await this.nodeOrchestrator.query(pingNode, this.timeoutMs);
+            const receivedAt = Date.now();
+            const latencyMs = receivedAt - startedAt;
+            this.logger.debug('keepalive ping success', { latencyMs });
+            if (this.onClockSkewMs) {
+                const serverT = response.attrs.t ? Number(response.attrs.t) : NaN;
+                if (Number.isFinite(serverT) && serverT > 0) {
+                    const halfRttMs = Math.round(latencyMs / 2);
+                    const clockSkewMs = serverT * 1000 - (startedAt + halfRttMs);
+                    this.onClockSkewMs(clockSkewMs);
+                }
+            }
         }
         catch (error) {
             this.logger.warn('keepalive ping failed, reconnecting socket', {

package/dist/esm/transport/node/WaMobileTcpSocket.js

@@ -1,6 +1,11 @@
 import { connect as netConnect } from 'node:net';
 import { WA_READY_STATES } from '../../protocol/constants.js';
 import { TEXT_ENCODER } from '../../util/bytes.js';
+/**
+ * `RawWebSocket`-shaped adapter over a raw Node TCP socket. Used by the
+ * mobile transport to speak the WhatsApp Mobile binary protocol over
+ * `tcp://host:port` URLs.
+ */
 export class WaMobileTcpSocket {
     constructor(url, _protocols, _options) {
         this.binaryType = 'arraybuffer';
@@ -111,4 +116,5 @@ function parseTcpUrl(url) {
     }
     return { host, port };
 }
+/** {@link RawWebSocketConstructor} alias for {@link WaMobileTcpSocket} – drop in via `WaCommsConfig.rawWebSocketConstructor`. */
 export const WaMobileTcpSocketCtor = WaMobileTcpSocket;

package/dist/esm/transport/node/WaNodeOrchestrator.js

@@ -1,6 +1,11 @@
 import { WA_DEFAULTS, WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from '../../protocol/constants.js';
 import { toError } from '../../util/primitives.js';
 import { createMobileNodeIdGenerator, createNodeIdGenerator } from './helpers.js';
+/**
+ * Issues outgoing binary nodes and matches incoming responses back to their
+ * caller's IQ promises by stanza id. Owns the per-process id generator and
+ * the in-flight query timeout map.
+ */
 export class WaNodeOrchestrator {
     constructor(options) {
         this.logger = options.logger;
@@ -83,8 +88,8 @@ export class WaNodeOrchestrator {
         if (this.pendingQueries.has(id)) {
             throw new Error(`pending node id collision: ${id}`);
         }
-        this.logger.debug('sending query node', {
-            id,
+        const queryLogger = this.logger.child({ id });
+        queryLogger.debug('sending query node', {
             tag: outbound.tag,
             type: outbound.attrs.type,
             timeoutMs
@@ -92,7 +97,7 @@ export class WaNodeOrchestrator {
         return new Promise((resolve, reject) => {
             const timer = setTimeout(() => {
                 this.pendingQueries.delete(id);
-                this.logger.warn('query node timeout', { id, timeoutMs });
+                queryLogger.warn('query node timeout', { timeoutMs });
                 reject(new Error(`query timeout (${id}) after ${timeoutMs}ms`));
             }, timeoutMs);
             this.pendingQueries.set(id, {
@@ -103,8 +108,7 @@ export class WaNodeOrchestrator {
             this.sendNodeFn(outbound).catch((error) => {
                 clearTimeout(timer);
                 this.pendingQueries.delete(id);
-                this.logger.warn('failed to send query node', {
-                    id,
+                queryLogger.warn('failed to send query node', {
                     message: toError(error).message
                 });
                 reject(toError(error));

package/dist/esm/transport/node/WaNodeTransport.js

@@ -3,16 +3,24 @@ import { ConsoleLogger } from '../../infra/log/ConsoleLogger.js';
 import { decodeBinaryNodeStanza, encodeBinaryNodeStanza } from '../binary/index.js';
 import { formatBinaryNodeAsXml } from '../node/xml.js';
 import { toError } from '../../util/primitives.js';
+/**
+ * Bridges encoded binary stanzas to/from {@link WaComms}: encodes outbound
+ * {@link BinaryNode}s into framed bytes, decodes incoming frames back into
+ * nodes, and re-emits `node_in`/`node_out`/`frame_in`/`frame_out`/
+ * `decode_error` events for debug observers.
+ */
 export class WaNodeTransport extends EventEmitter {
     constructor(logger = new ConsoleLogger('info')) {
         super();
         this.logger = logger;
         this.comms = null;
     }
+    /** Attaches (or detaches with `null`) the {@link WaComms} instance used to write frames. */
     bindComms(comms) {
         this.comms = comms;
         this.logger.debug('node transport bindComms', { connected: comms !== null });
     }
+    /** Encodes `node` as a stanza frame and writes it through the bound comms. Throws when not connected. */
     async sendNode(node) {
         const comms = this.comms;
         if (!comms) {
@@ -29,6 +37,11 @@ export class WaNodeTransport extends EventEmitter {
         this.emit('frame_out', frame);
         await comms.sendFrame(frame);
     }
+    /**
+     * Decodes an incoming frame and forwards the resulting {@link BinaryNode}
+     * to `onNode`. Stream-end frames are silently dropped; decode errors are
+     * logged and surfaced via the `decode_error` event without throwing.
+     */
     async dispatchIncomingFrame(frame, onNode) {
         this.emit('frame_in', frame);
         let node;

package/dist/esm/transport/node/builders/abprops.js

@@ -1,5 +1,5 @@
 import { WA_ABPROPS_PROTOCOL_VERSION } from '../../../protocol/abprops.js';
-import { WA_DEFAULTS, WA_XMLNS } from '../../../protocol/constants.js';
+import { WA_DEFAULTS, WA_IQ_TYPES, WA_XMLNS } from '../../../protocol/constants.js';
 import { buildIqNode } from '../../node/query.js';
 export function buildGetAbPropsIq(options) {
     const propsAttrs = {
@@ -11,7 +11,7 @@ export function buildGetAbPropsIq(options) {
     if (options?.refreshId !== undefined && options.refreshId !== null) {
         propsAttrs.refresh_id = `${options.refreshId}`;
     }
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.ABPROPS, [
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.ABPROPS, [
         {
             tag: 'props',
             attrs: propsAttrs

package/dist/esm/transport/node/builders/account-sync.js

@@ -1,4 +1,4 @@
-import { WA_DEFAULTS, WA_NODE_TAGS, WA_USYNC_CONTEXTS, WA_XMLNS } from '../../../protocol/constants.js';
+import { WA_DEFAULTS, WA_IQ_TYPES, WA_NODE_TAGS, WA_USYNC_CONTEXTS, WA_XMLNS } from '../../../protocol/constants.js';
 import { buildUsyncIq } from '../../node/builders/usync.js';
 import { buildIqNode } from '../../node/query.js';
 export function buildAccountDevicesSyncIq(userJids, sid) {
@@ -19,7 +19,7 @@ export function buildAccountDevicesSyncIq(userJids, sid) {
     });
 }
 export function buildAccountPictureSyncIq(meJid) {
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PROFILE_PICTURE, [
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PROFILE_PICTURE, [
         {
             tag: WA_NODE_TAGS.PICTURE,
             attrs: {
@@ -31,19 +31,11 @@ export function buildAccountPictureSyncIq(meJid) {
         target: meJid
     });
 }
-export function buildAccountPrivacySyncIq() {
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.PRIVACY, [
-        {
-            tag: WA_NODE_TAGS.PRIVACY,
-            attrs: {}
-        }
-    ]);
-}
 export function buildAccountBlocklistSyncIq() {
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BLOCKLIST);
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BLOCKLIST);
 }
-export function buildGroupsDirtySyncIq() {
-    return buildIqNode('get', WA_DEFAULTS.GROUP_SERVER, WA_XMLNS.GROUPS, [
+export function buildListParticipatingGroupsIq() {
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.GROUP_SERVER, WA_XMLNS.GROUPS, [
         {
             tag: WA_NODE_TAGS.PARTICIPATING,
             attrs: {},
@@ -61,7 +53,7 @@ export function buildGroupsDirtySyncIq() {
     ]);
 }
 export function buildNewsletterMetadataSyncIq() {
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.NEWSLETTER, [
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.NEWSLETTER, [
         {
             tag: WA_NODE_TAGS.MY_ADDONS,
             attrs: {
@@ -71,7 +63,7 @@ export function buildNewsletterMetadataSyncIq() {
     ]);
 }
 export function buildClearDirtyBitsIq(dirtyBits) {
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.DIRTY_BITS, dirtyBits.map((dirtyBit) => ({
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.DIRTY_BITS, dirtyBits.map((dirtyBit) => ({
         tag: 'clean',
         attrs: {
             type: dirtyBit.type,

package/dist/esm/transport/node/builders/bot.js

@@ -0,0 +1,38 @@
+import { WA_DEFAULTS } from '../../../protocol/defaults.js';
+import { WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from '../../../protocol/nodes.js';
+import { buildIqNode } from '../../node/query.js';
+const BOT_LIST_VERSION = '2';
+export function buildBotListIq(version = BOT_LIST_VERSION) {
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BOT, [
+        {
+            tag: WA_NODE_TAGS.BOT,
+            attrs: { v: version }
+        }
+    ]);
+}
+export function buildGetBotProfileUsyncQueryNode() {
+    return {
+        tag: WA_NODE_TAGS.BOT,
+        attrs: {},
+        content: [
+            {
+                tag: 'profile',
+                attrs: { v: '1' }
+            }
+        ]
+    };
+}
+export function buildBotProfileUsyncUserNodeContent(personaId) {
+    return [
+        {
+            tag: WA_NODE_TAGS.BOT,
+            attrs: {},
+            content: [
+                {
+                    tag: 'profile',
+                    attrs: personaId ? { persona_id: personaId } : {}
+                }
+            ]
+        }
+    ];
+}

package/dist/esm/transport/node/builders/business.js

@@ -1,8 +1,9 @@
-import { WA_DEFAULTS, WA_XMLNS } from '../../../protocol/constants.js';
+import { WA_BUSINESS_HOURS_MODES, WA_DEFAULTS, WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from '../../../protocol/constants.js';
+import { WA_BUSINESS_NOTIFICATION_TAGS } from '../../../protocol/notification.js';
 import { buildIqNode } from '../../node/query.js';
 export const WA_BUSINESS_PROFILE_VERSION = 116;
 export function buildGetBusinessProfileIq(jids, version = WA_BUSINESS_PROFILE_VERSION) {
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
         {
             tag: 'business_profile',
             attrs: { v: `${version}` },
@@ -57,7 +58,7 @@ export function buildEditBusinessProfileIq(input) {
     if (input.businessHours !== undefined) {
         children.push(buildBusinessHoursNode(input.businessHours));
     }
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
         {
             tag: 'business_profile',
             attrs: { v: '3', mutation_type: 'delta' },
@@ -65,19 +66,27 @@ export function buildEditBusinessProfileIq(input) {
         }
     ]);
 }
+const VALID_BUSINESS_HOURS_MODES = new Set(Object.values(WA_BUSINESS_HOURS_MODES));
 function buildBusinessHoursNode(hours) {
     const configNodes = new Array(hours.config.length);
     for (let i = 0; i < hours.config.length; i += 1) {
         const entry = hours.config[i];
+        if (!VALID_BUSINESS_HOURS_MODES.has(entry.mode)) {
+            throw new Error(`invalid business hours mode '${entry.mode}' (expected one of ${Object.values(WA_BUSINESS_HOURS_MODES).join(', ')}; closed days must be omitted)`);
+        }
         const attrs = {
             day_of_week: entry.dayOfWeek,
             mode: entry.mode
         };
-        if (entry.openTime !== undefined) {
-            attrs.open_time = `${entry.openTime}`;
-        }
-        if (entry.closeTime !== undefined) {
-            attrs.close_time = `${entry.closeTime}`;
+        // open_time / close_time only apply to specific_hours; the server drops
+        // them for open_24h / appointment_only.
+        if (entry.mode === WA_BUSINESS_HOURS_MODES.SPECIFIC_HOURS) {
+            if (entry.openTime !== undefined) {
+                attrs.open_time = `${entry.openTime}`;
+            }
+            if (entry.closeTime !== undefined) {
+                attrs.close_time = `${entry.closeTime}`;
+            }
         }
         configNodes[i] = { tag: 'business_hours_config', attrs };
     }
@@ -92,38 +101,29 @@ function buildBusinessHoursNode(hours) {
     };
 }
 export function buildGetVerifiedNameIq(jid) {
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
         {
             tag: 'verified_name',
             attrs: { jid }
         }
     ]);
 }
-export function buildUpdateCoverPhotoIq(id, timestamp, token) {
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
-        {
-            tag: 'business_profile',
-            attrs: { v: '3', mutation_type: 'delta' },
-            content: [
-                {
-                    tag: 'cover_photo',
-                    attrs: { op: 'update', id, ts: timestamp, token }
-                }
-            ]
-        }
-    ]);
+export function buildGetBusinessUsyncQueryNode() {
+    return {
+        tag: WA_NODE_TAGS.BUSINESS,
+        attrs: {},
+        content: [{ tag: WA_BUSINESS_NOTIFICATION_TAGS.VERIFIED_NAME, attrs: {} }]
+    };
 }
-export function buildDeleteCoverPhotoIq(id) {
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
+export function buildCoverPhotoIq(input) {
+    const attrs = input.op === 'update'
+        ? { op: 'update', id: input.id, ts: input.timestamp, token: input.token }
+        : { op: 'delete', id: input.id };
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
         {
             tag: 'business_profile',
             attrs: { v: '3', mutation_type: 'delta' },
-            content: [
-                {
-                    tag: 'cover_photo',
-                    attrs: { op: 'delete', id }
-                }
-            ]
+            content: [{ tag: 'cover_photo', attrs }]
         }
     ]);
 }

package/dist/esm/transport/node/builders/chatstate.js

@@ -0,0 +1,28 @@
+import { isBroadcastJid, isNewsletterJid, splitJid } from '../../../protocol/jid.js';
+import { WA_NODE_TAGS } from '../../../protocol/nodes.js';
+function assertChatstateJid(jid) {
+    if (isNewsletterJid(jid) || isBroadcastJid(jid)) {
+        throw new Error(`chatstate is not supported for jid: ${jid}`);
+    }
+    splitJid(jid);
+}
+export function buildChatstateNode(input) {
+    assertChatstateJid(input.jid);
+    if (input.state !== WA_NODE_TAGS.COMPOSING && input.media !== undefined) {
+        throw new Error('chatstate media is only valid with composing state');
+    }
+    const childAttrs = {};
+    if (input.media !== undefined) {
+        childAttrs.media = input.media;
+    }
+    return {
+        tag: WA_NODE_TAGS.CHATSTATE,
+        attrs: { to: input.jid },
+        content: [
+            {
+                tag: input.state,
+                attrs: childAttrs
+            }
+        ]
+    };
+}

package/dist/esm/transport/node/builders/community.js

@@ -0,0 +1,53 @@
+import { WA_IQ_TYPES, WA_XMLNS } from '../../../protocol/nodes.js';
+import { buildIqNode } from '../../node/query.js';
+export function buildLinkSubGroupsIq(input) {
+    if (input.subGroups.length === 0) {
+        throw new Error('linkSubGroups requires at least one subgroup');
+    }
+    return buildIqNode(WA_IQ_TYPES.SET, input.communityJid, WA_XMLNS.GROUPS, [
+        {
+            tag: 'links',
+            attrs: {},
+            content: [
+                {
+                    tag: 'link',
+                    attrs: { link_type: 'sub_group' },
+                    content: input.subGroups.map(({ jid, hidden }) => ({
+                        tag: 'group',
+                        attrs: { jid },
+                        ...(hidden ? { content: [{ tag: 'hidden_group', attrs: {} }] } : {})
+                    }))
+                }
+            ]
+        }
+    ]);
+}
+export function buildUnlinkSubGroupsIq(input) {
+    if (input.subGroupJids.length === 0) {
+        throw new Error('unlinkSubGroups requires at least one subgroup');
+    }
+    const groupAttrs = {};
+    if (input.removeOrphanedMembers) {
+        groupAttrs.remove_orphaned_members = 'true';
+    }
+    return buildIqNode(WA_IQ_TYPES.SET, input.communityJid, WA_XMLNS.GROUPS, [
+        {
+            tag: 'unlink',
+            attrs: { unlink_type: 'sub_group' },
+            content: input.subGroupJids.map((jid) => ({
+                tag: 'group',
+                attrs: { jid, ...groupAttrs }
+            }))
+        }
+    ]);
+}
+export function buildDeactivateCommunityIq(communityJid) {
+    return buildIqNode(WA_IQ_TYPES.SET, communityJid, WA_XMLNS.GROUPS, [
+        { tag: 'delete_parent', attrs: {} }
+    ]);
+}
+export function buildLinkedGroupsParticipantsIq(communityJid) {
+    return buildIqNode(WA_IQ_TYPES.GET, communityJid, WA_XMLNS.GROUPS, [
+        { tag: 'linked_groups_participants', attrs: {} }
+    ]);
+}

package/dist/esm/transport/node/builders/device.js

@@ -1,8 +1,8 @@
 import { WA_DEFAULTS } from '../../../protocol/defaults.js';
-import { WA_XMLNS } from '../../../protocol/nodes.js';
+import { WA_IQ_TYPES, WA_XMLNS } from '../../../protocol/nodes.js';
 import { buildIqNode } from '../../node/query.js';
 export function buildRemoveCompanionDeviceIq(deviceJid, reason) {
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.MD, [
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.MD, [
         {
             tag: 'remove-companion-device',
             attrs: { jid: deviceJid, reason }

package/dist/esm/transport/node/builders/email.js

@@ -1,8 +1,9 @@
 import { WA_DEFAULTS } from '../../../protocol/defaults.js';
 import { WA_EMAIL_LIMITS, WA_EMAIL_TAGS, WA_EMAIL_XMLNS } from '../../../protocol/email.js';
+import { WA_IQ_TYPES } from '../../../protocol/nodes.js';
 import { buildIqNode } from '../../node/query.js';
 export function buildGetEmailIq() {
-    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_EMAIL_XMLNS, [
+    return buildIqNode(WA_IQ_TYPES.GET, WA_DEFAULTS.HOST_DOMAIN, WA_EMAIL_XMLNS, [
         { tag: WA_EMAIL_TAGS.EMAIL, attrs: {} }
     ]);
 }
@@ -15,14 +16,14 @@ export function buildSetEmailIq(email, context) {
         emailChildren.push({ tag: WA_EMAIL_TAGS.CONTEXT, attrs: {}, content: context });
     }
     emailChildren.push({ tag: WA_EMAIL_TAGS.EMAIL_ADDRESS, attrs: {}, content: email });
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_EMAIL_XMLNS, [
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_EMAIL_XMLNS, [
         { tag: WA_EMAIL_TAGS.EMAIL, attrs: {}, content: emailChildren }
     ]);
 }
 export function buildRequestEmailVerificationCodeIq(input) {
     assertLocaleField('languageCode', input.languageCode);
     assertLocaleField('localeCode', input.localeCode);
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_EMAIL_XMLNS, [
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_EMAIL_XMLNS, [
         {
             tag: WA_EMAIL_TAGS.VERIFY_EMAIL,
             attrs: {},
@@ -37,7 +38,7 @@ export function buildVerifyEmailCodeIq(code) {
     if (code.length !== WA_EMAIL_LIMITS.CODE_LENGTH) {
         throw new Error(`verification code must be exactly ${WA_EMAIL_LIMITS.CODE_LENGTH} chars`);
     }
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_EMAIL_XMLNS, [
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_EMAIL_XMLNS, [
         {
             tag: WA_EMAIL_TAGS.VERIFY_EMAIL,
             attrs: {},
@@ -49,7 +50,7 @@ export function buildConfirmEmailIq(context) {
     const children = context !== undefined
         ? [{ tag: WA_EMAIL_TAGS.CONTEXT, attrs: {}, content: context }]
         : undefined;
-    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_EMAIL_XMLNS, [
+    return buildIqNode(WA_IQ_TYPES.SET, WA_DEFAULTS.HOST_DOMAIN, WA_EMAIL_XMLNS, [
         {
             tag: WA_EMAIL_TAGS.CONFIRM_EMAIL,
             attrs: {},

package/dist/esm/transport/node/builders/global.js

@@ -158,7 +158,7 @@ export function buildAckNode(input) {
         };
     }
     const attrs = {
-        class: 'receipt'
+        class: WA_MESSAGE_TAGS.RECEIPT
     };
     if (input.retryType) {
         attrs.type = input.typeOverride ?? WA_MESSAGE_TYPES.RECEIPT_TYPE_RETRY;