zapo-js 0.2.0 → 1.0.0

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

@@ -3,23 +3,30 @@ 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;
         this.nodeOrchestrator = options.nodeOrchestrator;
         this.getCommsFn = options.getComms;
-        this.intervalMs = options.intervalMs ?? WA_DEFAULTS.HEALTH_CHECK_INTERVAL_MS;
+        this.baseIntervalMs = options.intervalMs ?? WA_DEFAULTS.HEALTH_CHECK_INTERVAL_MS;
+        this.getIntervalMs = options.getIntervalMs;
         this.timeoutMs = options.timeoutMs ?? WA_DEFAULTS.DEAD_SOCKET_TIMEOUT_MS;
         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;
     }
     start() {
         this.logger.info('keepalive start', {
-            intervalMs: this.intervalMs,
+            intervalMs: this.resolveIntervalMs(),
             timeoutMs: this.timeoutMs,
             jitterRatio: this.jitterRatio,
             minJitterMs: this.minJitterMs
@@ -48,7 +55,7 @@ export class WaKeepAlive {
         this.logger.trace('keepalive scheduled', {
             generation,
             inMs: nextDelayMs,
-            baseIntervalMs: this.intervalMs
+            baseIntervalMs: this.resolveIntervalMs()
         });
     }
     async run(generation) {
@@ -80,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', {
@@ -110,20 +125,28 @@ export class WaKeepAlive {
         const normalized = value;
         return Math.min(Math.max(normalized, 0), KEEPALIVE_MAX_JITTER_RATIO);
     }
+    resolveIntervalMs() {
+        const candidate = this.getIntervalMs?.() ?? this.baseIntervalMs;
+        if (!Number.isFinite(candidate) || candidate <= 0) {
+            return this.baseIntervalMs;
+        }
+        return candidate;
+    }
     computeNextDelayMs() {
-        if (this.intervalMs <= 0) {
+        const intervalMs = this.resolveIntervalMs();
+        if (intervalMs <= 0) {
             return 0;
         }
         if (this.jitterRatio <= 0 && this.minJitterMs <= 0) {
-            return this.intervalMs;
+            return intervalMs;
         }
-        const ratioJitterMs = Math.floor(this.intervalMs * this.jitterRatio);
+        const ratioJitterMs = Math.floor(intervalMs * this.jitterRatio);
         const jitterWindowMs = Math.max(this.minJitterMs, ratioJitterMs);
         if (jitterWindowMs <= 0) {
-            return this.intervalMs;
+            return intervalMs;
         }
         const offsetMs = Math.floor(Math.random() * (jitterWindowMs * 2 + 1) - jitterWindowMs);
-        return Math.max(1, this.intervalMs + offsetMs);
+        return Math.max(1, intervalMs + offsetMs);
     }
     clearTimer() {
         if (!this.timer) {

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

@@ -0,0 +1,120 @@
+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';
+        this.readyState = WA_READY_STATES.CONNECTING;
+        this.onopen = null;
+        this.onclose = null;
+        this.onerror = null;
+        this.onmessage = null;
+        this.closedCode = 1000;
+        this.closedReason = '';
+        this.closedClean = true;
+        this.forceCloseTimer = null;
+        const { host, port } = parseTcpUrl(url);
+        this.socket = netConnect({ host, port });
+        this.socket.on('connect', () => {
+            if (this.readyState !== WA_READY_STATES.CONNECTING)
+                return;
+            this.readyState = WA_READY_STATES.OPEN;
+            this.onopen?.({});
+        });
+        this.socket.on('data', (chunk) => {
+            if (!this.onmessage || this.readyState !== WA_READY_STATES.OPEN)
+                return;
+            const copy = new Uint8Array(chunk.byteLength);
+            copy.set(chunk);
+            this.onmessage({ data: copy });
+        });
+        this.socket.on('error', (err) => {
+            this.closedClean = false;
+            this.closedReason = err.message;
+            this.onerror?.({ reason: err.message });
+        });
+        this.socket.on('close', (hadError) => {
+            this.readyState = WA_READY_STATES.CLOSED;
+            if (this.forceCloseTimer) {
+                clearTimeout(this.forceCloseTimer);
+                this.forceCloseTimer = null;
+            }
+            if (hadError)
+                this.closedClean = false;
+            this.onclose?.({
+                code: this.closedCode,
+                reason: this.closedReason,
+                wasClean: this.closedClean
+            });
+        });
+    }
+    send(data) {
+        if (this.readyState !== WA_READY_STATES.OPEN) {
+            throw new Error('WaMobileTcpSocket: send() called on non-OPEN socket');
+        }
+        let bytes;
+        if (typeof data === 'string') {
+            bytes = TEXT_ENCODER.encode(data);
+        }
+        else if (data instanceof Uint8Array) {
+            bytes = data;
+        }
+        else {
+            bytes = new Uint8Array(data);
+        }
+        this.socket.write(bytes);
+    }
+    close(code, reason) {
+        if (this.readyState === WA_READY_STATES.CLOSED)
+            return;
+        this.readyState = WA_READY_STATES.CLOSING;
+        this.closedCode = code ?? 1000;
+        this.closedReason = reason ?? '';
+        this.socket.end();
+        this.forceCloseTimer = setTimeout(() => {
+            this.forceCloseTimer = null;
+            if (this.readyState !== WA_READY_STATES.CLOSED) {
+                this.socket.destroy();
+            }
+        }, 5000);
+        this.forceCloseTimer.unref();
+    }
+}
+function parseTcpUrl(url) {
+    let work = url;
+    if (work.startsWith('tcp://')) {
+        work = work.slice('tcp://'.length);
+    }
+    const queryIdx = work.indexOf('?');
+    if (queryIdx >= 0) {
+        work = work.slice(0, queryIdx);
+    }
+    const slash = work.indexOf('/');
+    if (slash >= 0) {
+        work = work.slice(0, slash);
+    }
+    const colon = work.lastIndexOf(':');
+    const host = colon === -1 ? work : work.slice(0, colon);
+    if (host.length === 0) {
+        throw new Error(`WaMobileTcpSocket: invalid host in ${JSON.stringify(url)}`);
+    }
+    if (colon === -1) {
+        return { host, port: 443 };
+    }
+    const portText = work.slice(colon + 1);
+    if (!/^\d+$/.test(portText)) {
+        throw new Error(`WaMobileTcpSocket: invalid port in ${JSON.stringify(url)}`);
+    }
+    const port = Number(portText);
+    if (port < 1 || port > 65535) {
+        throw new Error(`WaMobileTcpSocket: port out of range in ${JSON.stringify(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,12 +1,18 @@
 import { WA_DEFAULTS, WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from '../../protocol/constants.js';
 import { toError } from '../../util/primitives.js';
-import { createNodeIdGenerator } from './helpers.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;
         this.sendNodeFn = options.sendNode;
         this.defaultTimeoutMs = options.defaultTimeoutMs ?? WA_DEFAULTS.NODE_QUERY_TIMEOUT_MS;
         this.hostDomain = options.hostDomain ?? WA_DEFAULTS.HOST_DOMAIN;
+        this.mobileIqIdFormat = options.mobileIqIdFormat === true;
         this.idGenerator = null;
         this.idGeneratorReady = null;
         this.pendingQueries = new Map();
@@ -69,12 +75,12 @@ export class WaNodeOrchestrator {
         this.logger.debug('auto-responded to ping iq', { id: node.attrs.id, xmlns });
         return true;
     }
-    async sendNode(node) {
-        const outbound = await this.withAutoId(node);
+    async sendNode(node, autoId = true) {
+        const outbound = autoId ? await this.withAutoId(node) : node;
         await this.sendNodeFn(outbound);
     }
-    async query(node, timeoutMs = this.defaultTimeoutMs) {
-        const outbound = await this.withAutoId(node);
+    async query(node, timeoutMs = this.defaultTimeoutMs, options = {}) {
+        const outbound = await this.withAutoId(node, options.useSystemId === true);
         const id = outbound.attrs.id;
         if (!id) {
             throw new Error('query node id is required');
@@ -82,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
@@ -91,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, {
@@ -102,20 +108,20 @@ 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));
             });
         });
     }
-    async withAutoId(node) {
+    async withAutoId(node, useSystemId = false) {
         if (node.attrs.id) {
             return node;
         }
-        const generatedId = (await this.getIdGenerator()).next();
-        this.logger.trace('generated stanza id', { id: generatedId });
+        const generator = await this.getIdGenerator();
+        const generatedId = useSystemId && generator.nextSystem ? generator.nextSystem() : generator.next();
+        this.logger.trace('generated stanza id', { id: generatedId, system: useSystemId });
         return {
             ...node,
             attrs: {
@@ -128,6 +134,13 @@ export class WaNodeOrchestrator {
         if (this.idGenerator) {
             return this.idGenerator;
         }
+        if (this.mobileIqIdFormat) {
+            this.idGenerator = createMobileNodeIdGenerator();
+            this.logger.debug('generated stanza prefix (mobile)', {
+                prefix: this.idGenerator.prefix
+            });
+            return this.idGenerator;
+        }
         if (!this.idGeneratorReady) {
             this.idGeneratorReady = createNodeIdGenerator();
         }

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

@@ -0,0 +1,20 @@
+import { WA_ABPROPS_PROTOCOL_VERSION } from '../../../protocol/abprops.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 = {
+        protocol: WA_ABPROPS_PROTOCOL_VERSION
+    };
+    if (options?.hash) {
+        propsAttrs.hash = options.hash;
+    }
+    if (options?.refreshId !== undefined && options.refreshId !== null) {
+        propsAttrs.refresh_id = `${options.refreshId}`;
+    }
+    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

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