zapo-js 0.3.0 → 1.0.0

package/dist/transport/node/builders/newsletter.js

@@ -0,0 +1,183 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildNewsletterMessageNode = buildNewsletterMessageNode;
+exports.buildNewsletterViewReceiptNode = buildNewsletterViewReceiptNode;
+exports.buildNewsletterSubscribeLiveUpdatesIq = buildNewsletterSubscribeLiveUpdatesIq;
+exports.buildNewsletterMessagesIq = buildNewsletterMessagesIq;
+exports.buildNewsletterMessageUpdatesIq = buildNewsletterMessageUpdatesIq;
+const defaults_1 = require("../../../protocol/defaults");
+const message_1 = require("../../../protocol/message");
+const nodes_1 = require("../../../protocol/nodes");
+const query_1 = require("../../node/query");
+function plaintextChild(plaintext, mediaType) {
+    return {
+        tag: nodes_1.WA_NODE_TAGS.PLAINTEXT,
+        attrs: mediaType ? { mediatype: mediaType } : {},
+        content: plaintext
+    };
+}
+function pollMetaChild(polltype, contentType) {
+    const attrs = { polltype };
+    if (contentType) {
+        attrs.contenttype = contentType;
+    }
+    return { tag: 'meta', attrs };
+}
+function buildNewsletterMessageNode(input) {
+    const attrs = { to: input.to };
+    let content;
+    switch (input.kind) {
+        case 'text':
+            attrs.id = input.id;
+            attrs.type = 'text';
+            content = [plaintextChild(input.plaintext)];
+            break;
+        case 'media':
+            attrs.id = input.id;
+            attrs.type = 'media';
+            if (input.mediaHandle) {
+                attrs.media_id = input.mediaHandle;
+            }
+            content = [plaintextChild(input.plaintext, input.mediaType)];
+            break;
+        case 'edit-text':
+            attrs.id = input.parentMessageId;
+            attrs.type = 'text';
+            attrs.edit = message_1.WA_EDIT_ATTRS.NEWSLETTER_EDIT;
+            content = [plaintextChild(input.plaintext)];
+            break;
+        case 'edit-media':
+            attrs.id = input.parentMessageId;
+            attrs.type = 'media';
+            attrs.edit = message_1.WA_EDIT_ATTRS.NEWSLETTER_EDIT;
+            content = [plaintextChild(input.plaintext, input.mediaType)];
+            break;
+        case 'reaction':
+            attrs.id = input.id;
+            attrs.server_id = String(input.parentMessageServerId);
+            attrs.type = 'reaction';
+            content = [{ tag: 'reaction', attrs: { code: input.reactionCode } }];
+            break;
+        case 'reaction-revoke':
+            attrs.id = input.id;
+            attrs.server_id = String(input.parentMessageServerId);
+            attrs.type = 'reaction';
+            attrs.edit = message_1.WA_EDIT_ATTRS.SENDER_REVOKE;
+            content = [{ tag: 'reaction', attrs: {} }];
+            break;
+        case 'revoke':
+            attrs.id = input.originalMessageId;
+            attrs.type = 'text';
+            attrs.edit = message_1.WA_EDIT_ATTRS.ADMIN_REVOKE;
+            content = [{ tag: nodes_1.WA_NODE_TAGS.PLAINTEXT, attrs: {} }];
+            break;
+        case 'poll-creation':
+            attrs.id = input.id;
+            attrs.type = 'poll';
+            content = [
+                plaintextChild(input.plaintext),
+                pollMetaChild('creation', input.contentType)
+            ];
+            break;
+        case 'poll-vote':
+            if (input.votes.length === 0) {
+                throw new Error('newsletter poll vote requires at least one vote payload');
+            }
+            attrs.id = input.id;
+            attrs.server_id = String(input.parentMessageServerId);
+            attrs.type = 'poll';
+            content = [
+                {
+                    tag: 'votes',
+                    attrs: {},
+                    content: input.votes.map((vote) => ({
+                        tag: 'vote',
+                        attrs: {},
+                        content: vote
+                    }))
+                },
+                pollMetaChild('vote', input.contentType)
+            ];
+            break;
+    }
+    if (input.additionalAttributes) {
+        Object.assign(attrs, input.additionalAttributes);
+    }
+    return content === undefined ? { tag: 'message', attrs } : { tag: 'message', attrs, content };
+}
+function buildNewsletterViewReceiptNode(input) {
+    if (input.itemServerIds.length === 0) {
+        throw new Error('newsletter view receipt requires at least one item');
+    }
+    return {
+        tag: 'receipt',
+        attrs: {
+            to: input.to,
+            id: input.id,
+            type: 'view'
+        },
+        content: [
+            {
+                tag: 'list',
+                attrs: {},
+                content: input.itemServerIds.map((serverId) => ({
+                    tag: 'item',
+                    attrs: { server_id: String(serverId) }
+                }))
+            }
+        ]
+    };
+}
+function buildNewsletterSubscribeLiveUpdatesIq(newsletterJid) {
+    return (0, query_1.buildIqNode)(nodes_1.WA_IQ_TYPES.SET, newsletterJid, nodes_1.WA_XMLNS.NEWSLETTER, [
+        {
+            tag: 'live_updates',
+            attrs: {}
+        }
+    ]);
+}
+function buildNewsletterMessagesIq(input) {
+    const attrs = {
+        type: 'jid',
+        jid: input.newsletterJid,
+        count: String(input.count)
+    };
+    if (input.before !== undefined) {
+        attrs.before = String(input.before);
+    }
+    else if (input.after !== undefined) {
+        attrs.after = String(input.after);
+    }
+    if (input.viewRole) {
+        attrs.view_role = input.viewRole;
+    }
+    return (0, query_1.buildIqNode)(nodes_1.WA_IQ_TYPES.GET, defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.NEWSLETTER, [
+        {
+            tag: 'messages',
+            attrs
+        }
+    ]);
+}
+function buildNewsletterMessageUpdatesIq(input) {
+    if (input.before === undefined && input.after === undefined) {
+        throw new Error('newsletter message updates require before or after');
+    }
+    const attrs = {
+        count: String(input.count)
+    };
+    if (input.since !== undefined) {
+        attrs.since = String(input.since);
+    }
+    if (input.before !== undefined) {
+        attrs.before = String(input.before);
+    }
+    else if (input.after !== undefined) {
+        attrs.after = String(input.after);
+    }
+    return (0, query_1.buildIqNode)(nodes_1.WA_IQ_TYPES.GET, input.newsletterJid, nodes_1.WA_XMLNS.NEWSLETTER, [
+        {
+            tag: 'message_updates',
+            attrs
+        }
+    ]);
+}

package/dist/transport/node/builders/passive.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPassiveModeIqNode = buildPassiveModeIqNode;
+const constants_1 = require("../../../protocol/constants");
+const query_1 = require("../../node/query");
+function buildPassiveModeIqNode(mode) {
+    return (0, query_1.buildIqNode)(constants_1.WA_IQ_TYPES.SET, constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.PASSIVE, [
+        { tag: mode, attrs: {} }
+    ]);
+}

package/dist/transport/node/builders/prekeys.js

@@ -65,10 +65,10 @@ function buildPreKeyUploadIq(registrationInfo, signedPreKey, preKeys) {
             ]
         }))
     }, buildSignedPreKeyNode(signedPreKey));
-    return (0, query_1.buildIqNode)('set', constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.SIGNAL, children);
+    return (0, query_1.buildIqNode)(constants_1.WA_IQ_TYPES.SET, constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.SIGNAL, children);
 }
 function buildSignedPreKeyRotateIq(signedPreKey) {
-    return (0, query_1.buildIqNode)('set', constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.SIGNAL, [
+    return (0, query_1.buildIqNode)(constants_1.WA_IQ_TYPES.SET, constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.SIGNAL, [
         {
             tag: constants_1.WA_NODE_TAGS.ROTATE,
             attrs: {},
@@ -77,7 +77,7 @@ function buildSignedPreKeyRotateIq(signedPreKey) {
     ]);
 }
 function buildMissingPreKeysFetchIq(users) {
-    return (0, query_1.buildIqNode)('get', constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.SIGNAL, [
+    return (0, query_1.buildIqNode)(constants_1.WA_IQ_TYPES.GET, constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.SIGNAL, [
         {
             tag: constants_1.WA_NODE_TAGS.KEY_FETCH,
             attrs: {},

package/dist/transport/node/builders/presence.js

@@ -1,6 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildPresenceNode = buildPresenceNode;
+exports.buildPresenceSubscribeNode = buildPresenceSubscribeNode;
+const jid_1 = require("../../../protocol/jid");
+const nodes_1 = require("../../../protocol/nodes");
+const presence_1 = require("../../../protocol/presence");
 function buildPresenceNode(input) {
     const attrs = {};
     if (input?.type) {
@@ -10,7 +14,30 @@ function buildPresenceNode(input) {
         attrs.name = input.name;
     }
     return {
-        tag: 'presence',
+        tag: nodes_1.WA_NODE_TAGS.PRESENCE,
+        attrs
+    };
+}
+function assertSubscribeJid(jid) {
+    if ((0, jid_1.isNewsletterJid)(jid) || (0, jid_1.isBroadcastJid)(jid)) {
+        throw new Error(`presence subscribe is not supported for jid: ${jid}`);
+    }
+    (0, jid_1.splitJid)(jid);
+}
+function buildPresenceSubscribeNode(input) {
+    assertSubscribeJid(input.jid);
+    const attrs = {
+        type: presence_1.WA_PRESENCE_TYPES.SUBSCRIBE,
+        to: input.jid
+    };
+    if (input.name !== undefined) {
+        attrs.name = input.name;
+    }
+    if (input.context !== undefined) {
+        attrs.context = input.context;
+    }
+    return {
+        tag: nodes_1.WA_NODE_TAGS.PRESENCE,
         attrs
     };
 }

package/dist/transport/node/builders/privacy-token.js

@@ -9,7 +9,7 @@ const nodes_1 = require("../../../protocol/nodes");
 const privacy_token_1 = require("../../../protocol/privacy-token");
 const query_1 = require("../../node/query");
 function buildPrivacyTokenIqNode(input) {
-    return (0, query_1.buildIqNode)('set', defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.PRIVACY, [
+    return (0, query_1.buildIqNode)(nodes_1.WA_IQ_TYPES.SET, defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.PRIVACY, [
         {
             tag: privacy_token_1.WA_PRIVACY_TOKEN_TAGS.TOKENS,
             attrs: {},

package/dist/transport/node/builders/privacy.js

@@ -10,12 +10,12 @@ const nodes_1 = require("../../../protocol/nodes");
 const privacy_1 = require("../../../protocol/privacy");
 const query_1 = require("../../node/query");
 function buildGetPrivacySettingsIq() {
-    return (0, query_1.buildIqNode)('get', defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.PRIVACY, [
+    return (0, query_1.buildIqNode)(nodes_1.WA_IQ_TYPES.GET, defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.PRIVACY, [
         { tag: nodes_1.WA_NODE_TAGS.PRIVACY, attrs: {} }
     ]);
 }
 function buildSetPrivacyCategoryIq(category, value) {
-    return (0, query_1.buildIqNode)('set', defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.PRIVACY, [
+    return (0, query_1.buildIqNode)(nodes_1.WA_IQ_TYPES.SET, defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.PRIVACY, [
         {
             tag: nodes_1.WA_NODE_TAGS.PRIVACY,
             attrs: {},
@@ -29,7 +29,7 @@ function buildSetPrivacyCategoryIq(category, value) {
     ]);
 }
 function buildGetPrivacyDisallowedListIq(category) {
-    return (0, query_1.buildIqNode)('get', defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.PRIVACY, [
+    return (0, query_1.buildIqNode)(nodes_1.WA_IQ_TYPES.GET, defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.PRIVACY, [
         {
             tag: nodes_1.WA_NODE_TAGS.PRIVACY,
             attrs: {},
@@ -43,10 +43,10 @@ function buildGetPrivacyDisallowedListIq(category) {
     ]);
 }
 function buildGetBlocklistIq() {
-    return (0, query_1.buildIqNode)('get', defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.BLOCKLIST);
+    return (0, query_1.buildIqNode)(nodes_1.WA_IQ_TYPES.GET, defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.BLOCKLIST);
 }
 function buildBlocklistChangeIq(jid, action) {
-    return (0, query_1.buildIqNode)('set', defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.BLOCKLIST, [
+    return (0, query_1.buildIqNode)(nodes_1.WA_IQ_TYPES.SET, defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.BLOCKLIST, [
         {
             tag: 'item',
             attrs: { jid, action }

package/dist/transport/node/builders/profile.js

@@ -5,6 +5,9 @@ exports.buildSetProfilePictureIq = buildSetProfilePictureIq;
 exports.buildDeleteProfilePictureIq = buildDeleteProfilePictureIq;
 exports.buildSetStatusIq = buildSetStatusIq;
 exports.buildGetDisappearingModeUsyncQueryNode = buildGetDisappearingModeUsyncQueryNode;
+exports.buildSetDisappearingModeIq = buildSetDisappearingModeIq;
+exports.buildGetTextStatusUsyncQueryNode = buildGetTextStatusUsyncQueryNode;
+exports.buildGetUsernameUsyncQueryNode = buildGetUsernameUsyncQueryNode;
 exports.buildGetStatusUsyncQueryNodes = buildGetStatusUsyncQueryNodes;
 const constants_1 = require("../../../protocol/constants");
 const query_1 = require("../../node/query");
@@ -16,7 +19,7 @@ function buildGetProfilePictureIq(targetJid, type = 'preview', existingId) {
     if (existingId) {
         pictureAttrs.id = existingId;
     }
-    return (0, query_1.buildIqNode)('get', constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.PROFILE_PICTURE, [
+    return (0, query_1.buildIqNode)(constants_1.WA_IQ_TYPES.GET, constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.PROFILE_PICTURE, [
         {
             tag: constants_1.WA_NODE_TAGS.PICTURE,
             attrs: pictureAttrs
@@ -30,7 +33,7 @@ function buildSetProfilePictureIq(imageBytes, targetJid) {
     if (targetJid) {
         attrs.target = targetJid;
     }
-    return (0, query_1.buildIqNode)('set', constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.PROFILE_PICTURE, [
+    return (0, query_1.buildIqNode)(constants_1.WA_IQ_TYPES.SET, constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.PROFILE_PICTURE, [
         {
             tag: constants_1.WA_NODE_TAGS.PICTURE,
             attrs: { type: 'image' },
@@ -43,12 +46,12 @@ function buildDeleteProfilePictureIq(targetJid) {
     if (targetJid) {
         attrs.target = targetJid;
     }
-    return (0, query_1.buildIqNode)('set', constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.PROFILE_PICTURE, undefined, attrs);
+    return (0, query_1.buildIqNode)(constants_1.WA_IQ_TYPES.SET, constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.PROFILE_PICTURE, undefined, attrs);
 }
 function buildSetStatusIq(text) {
-    return (0, query_1.buildIqNode)('set', constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.STATUS, [
+    return (0, query_1.buildIqNode)(constants_1.WA_IQ_TYPES.SET, constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.STATUS, [
         {
-            tag: 'status',
+            tag: constants_1.WA_NODE_TAGS.STATUS,
             attrs: {},
             content: text
         }
@@ -56,7 +59,27 @@ function buildSetStatusIq(text) {
 }
 function buildGetDisappearingModeUsyncQueryNode() {
     return {
-        tag: 'disappearing_mode',
+        tag: constants_1.WA_NODE_TAGS.DISAPPEARING_MODE,
+        attrs: {}
+    };
+}
+function buildSetDisappearingModeIq(durationSeconds) {
+    return (0, query_1.buildIqNode)(constants_1.WA_IQ_TYPES.SET, constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.DISAPPEARING_MODE, [
+        {
+            tag: constants_1.WA_NODE_TAGS.DISAPPEARING_MODE,
+            attrs: { duration: String(durationSeconds) }
+        }
+    ]);
+}
+function buildGetTextStatusUsyncQueryNode() {
+    return {
+        tag: constants_1.WA_NODE_TAGS.TEXT_STATUS,
+        attrs: {}
+    };
+}
+function buildGetUsernameUsyncQueryNode() {
+    return {
+        tag: constants_1.WA_NODE_TAGS.USERNAME,
         attrs: {}
     };
 }
@@ -67,7 +90,7 @@ function buildGetStatusUsyncQueryNodes() {
             attrs: {}
         },
         {
-            tag: 'status',
+            tag: constants_1.WA_NODE_TAGS.STATUS,
             attrs: {}
         },
         {

package/dist/transport/node/builders/tos.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTosQueryIq = buildTosQueryIq;
+exports.buildTosUpdateIq = buildTosUpdateIq;
+exports.parseTosQueryResponse = parseTosQueryResponse;
+const defaults_1 = require("../../../protocol/defaults");
+const nodes_1 = require("../../../protocol/nodes");
+const query_1 = require("../../node/query");
+const primitives_1 = require("../../../util/primitives");
+function noticeNodes(noticeIds) {
+    return noticeIds.map((id) => ({
+        tag: 'notice',
+        attrs: { id }
+    }));
+}
+function buildTosQueryIq(noticeIds) {
+    if (noticeIds.length === 0) {
+        throw new Error('tos query requires at least one notice id');
+    }
+    return (0, query_1.buildIqNode)(nodes_1.WA_IQ_TYPES.GET, defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.TOS, [
+        {
+            tag: 'request',
+            attrs: {},
+            content: noticeNodes(noticeIds)
+        }
+    ]);
+}
+function buildTosUpdateIq(noticeIds) {
+    if (noticeIds.length === 0) {
+        throw new Error('tos update requires at least one notice id');
+    }
+    return (0, query_1.buildIqNode)(nodes_1.WA_IQ_TYPES.SET, defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.TOS, [
+        {
+            tag: 'request',
+            attrs: { type: 'session_update' },
+            content: noticeNodes(noticeIds)
+        }
+    ]);
+}
+function parseTosQueryResponse(node) {
+    const tosNode = Array.isArray(node.content)
+        ? node.content.find((child) => child.tag === 'tos')
+        : undefined;
+    if (!tosNode) {
+        throw new Error('tos response missing <tos> node');
+    }
+    const refreshSeconds = (0, primitives_1.parseOptionalInt)(tosNode.attrs.refresh) ?? 0;
+    const notices = [];
+    if (Array.isArray(tosNode.content)) {
+        for (const child of tosNode.content) {
+            if (child.tag !== 'notice')
+                continue;
+            const id = child.attrs.id;
+            if (!id)
+                continue;
+            notices.push({
+                id,
+                accepted: child.attrs.state !== 'false'
+            });
+        }
+    }
+    return { refreshSeconds, notices };
+}

package/dist/transport/node/builders/usync.js

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildUsyncUserNode = buildUsyncUserNode;
+exports.iterateUsyncUsers = iterateUsyncUsers;
+exports.parseUsyncResultEnvelope = parseUsyncResultEnvelope;
 exports.buildUsyncIq = buildUsyncIq;
 const constants_1 = require("../../../protocol/constants");
+const helpers_1 = require("../../node/helpers");
 const query_1 = require("../../node/query");
+const primitives_1 = require("../../../util/primitives");
 function buildUsyncUserNode(input) {
     return {
         tag: constants_1.WA_NODE_TAGS.USER,
@@ -14,6 +18,53 @@ function buildUsyncUserNode(input) {
         ...(input.content !== undefined ? { content: input.content } : {})
     };
 }
+function iterateUsyncUsers(result) {
+    const usyncNode = (0, helpers_1.findNodeChild)(result, constants_1.WA_NODE_TAGS.USYNC);
+    if (!usyncNode)
+        return null;
+    const listNode = (0, helpers_1.findNodeChild)(usyncNode, constants_1.WA_NODE_TAGS.LIST);
+    if (!listNode)
+        return null;
+    return (0, helpers_1.getNodeChildrenByTag)(listNode, constants_1.WA_NODE_TAGS.USER);
+}
+const EMPTY_USYNC_RESULT_ENVELOPE = Object.freeze({
+    errors: Object.freeze({}),
+    refresh: Object.freeze({})
+});
+/**
+ * Walks a `usync` IQ result and extracts per-protocol error envelopes plus
+ * `refresh` hints. Returns an empty envelope when the result has no `usync`
+ * payload.
+ */
+function parseUsyncResultEnvelope(result) {
+    const usyncNode = (0, helpers_1.findNodeChild)(result, constants_1.WA_NODE_TAGS.USYNC);
+    if (!usyncNode)
+        return EMPTY_USYNC_RESULT_ENVELOPE;
+    const resultNode = (0, helpers_1.findNodeChild)(usyncNode, 'result');
+    if (!resultNode)
+        return EMPTY_USYNC_RESULT_ENVELOPE;
+    if (!Array.isArray(resultNode.content))
+        return EMPTY_USYNC_RESULT_ENVELOPE;
+    const errors = {};
+    const refresh = {};
+    for (let i = 0; i < resultNode.content.length; i += 1) {
+        const protoNode = resultNode.content[i];
+        const errorNode = (0, helpers_1.findNodeChild)(protoNode, constants_1.WA_NODE_TAGS.ERROR);
+        if (errorNode) {
+            errors[protoNode.tag] = {
+                code: (0, primitives_1.parseOptionalInt)(errorNode.attrs.code) ?? null,
+                text: errorNode.attrs.text ?? null,
+                backoffSeconds: (0, primitives_1.parseOptionalInt)(errorNode.attrs.backoff) ?? null
+            };
+            continue;
+        }
+        const refreshSeconds = (0, primitives_1.parseOptionalInt)(protoNode.attrs.refresh);
+        if (refreshSeconds !== undefined) {
+            refresh[protoNode.tag] = refreshSeconds;
+        }
+    }
+    return { errors, refresh };
+}
 function buildUsyncIq(input) {
     if (input.queryProtocolNodes.length === 0) {
         throw new Error('usync query must include at least one protocol node');
@@ -22,7 +73,7 @@ function buildUsyncIq(input) {
     for (let index = 0; index < input.users.length; index += 1) {
         users[index] = buildUsyncUserNode(input.users[index]);
     }
-    return (0, query_1.buildIqNode)('get', input.hostDomain ?? constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.USYNC, [
+    return (0, query_1.buildIqNode)(constants_1.WA_IQ_TYPES.GET, input.hostDomain ?? constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.USYNC, [
         {
             tag: constants_1.WA_NODE_TAGS.USYNC,
             attrs: {

package/dist/transport/node/helpers.js

@@ -13,7 +13,6 @@ exports.hasNodeChild = hasNodeChild;
 exports.decodeNodeContentUtf8OrBytes = decodeNodeContentUtf8OrBytes;
 exports.getNodeTextContent = getNodeTextContent;
 exports.decodeNodeContentBase64OrBytes = decodeNodeContentBase64OrBytes;
-exports.formatNodeIdPrefixFromSeed = formatNodeIdPrefixFromSeed;
 exports.createNodeIdGenerator = createNodeIdGenerator;
 exports.createMobileNodeIdGenerator = createMobileNodeIdGenerator;
 const _crypto_1 = require("../../crypto/index.js");
@@ -145,6 +144,8 @@ function decodeNodeContentUtf8OrBytes(value, field) {
     throw new Error(`node ${field} has no binary content`);
 }
 function getNodeTextContent(node) {
+    if (!node)
+        return undefined;
     const content = node.content;
     if (content instanceof Uint8Array)
         return bytes_1.TEXT_DECODER.decode(content);

package/dist/transport/node/mex/argo-decoder.js

@@ -41,7 +41,7 @@ async function loadArgo() {
     if (cachedArgo !== undefined)
         return cachedArgo;
     try {
-        cachedArgo = (await Promise.resolve().then(() => __importStar(require('argo-codec'))));
+        cachedArgo = await Promise.resolve().then(() => __importStar(require('argo-codec')));
     }
     catch {
         cachedArgo = null;
@@ -161,7 +161,7 @@ function readDesc(ctx) {
 }
 function readError(ctx) {
     const message = readStringFromBlock(ctx);
-    skipOptional(ctx); // location — never observed in MEX errors so far
+    skipOptional(ctx); // location – never observed in MEX errors so far
     const path = readPath(ctx);
     const extensions = readOptionalDesc(ctx);
     return { message, path, extensions };

package/dist/transport/node/mex/client.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.runMexQuery = runMexQuery;
 exports.dispatchMexQuery = dispatchMexQuery;
+const _mex_1 = require("../../../mex.js");
 const constants_1 = require("../../../protocol/constants");
 const helpers_1 = require("../../node/helpers");
 const argo_decoder_1 = require("../../node/mex/argo-decoder");
@@ -8,6 +10,27 @@ const query_1 = require("../../node/query");
 const bytes_1 = require("../../../util/bytes");
 const primitives_1 = require("../../../util/primitives");
 const MEX_DEFAULT_TIMEOUT_MS = 32000;
+/**
+ * Typed wrapper around `dispatchMexQuery` that resolves persist IDs from the
+ * generated `WA_MEX_PERSIST_IDS` table. The op key constrains the `variables`
+ * shape via `WaMexOperationVariables` and defaults the response to
+ * `WaMexOperationResponses[K] | null` (the response tree the extractor walked
+ * from the Relay `operation.selections`; leaves are `unknown` since Relay
+ * strips scalar types at codegen).
+ */
+async function runMexQuery(socket, opKey, variables) {
+    const persist = _mex_1.WA_MEX_PERSIST_IDS[opKey];
+    if (!persist) {
+        throw new Error(`mex/${String(opKey)} persist IDs not found`);
+    }
+    const { data } = await dispatchMexQuery(socket, {
+        docId: persist.docId,
+        clientDocId: persist.clientDocId,
+        opName: opKey,
+        variables: variables
+    });
+    return data;
+}
 async function dispatchMexQuery(socket, args) {
     const body = JSON.stringify({
         queryId: args.clientDocId,

package/dist/transport/node/query.js

@@ -7,6 +7,11 @@ exports.queryWithContext = queryWithContext;
 const constants_1 = require("../../protocol/constants");
 const helpers_1 = require("../node/helpers");
 const primitives_1 = require("../../util/primitives");
+/**
+ * Builds an IQ stanza (`<iq type="get|set" to="..." xmlns="..."/>`) with the
+ * given children/attrs. The caller is responsible for the `id` attribute
+ * (the transport assigns one automatically when omitted).
+ */
 function buildIqNode(type, to, xmlns, content, attrs = {}) {
     return {
         tag: constants_1.WA_NODE_TAGS.IQ,
@@ -19,6 +24,10 @@ function buildIqNode(type, to, xmlns, content, attrs = {}) {
         ...(content !== undefined ? { content } : {})
     };
 }
+/**
+ * Reads the standard error envelope from an IQ stanza, returning the string
+ * `code`/`text` and (when parseable) the numeric `code`.
+ */
 function parseIqError(node) {
     const errorNode = (0, helpers_1.findNodeChild)(node, constants_1.WA_NODE_TAGS.ERROR);
     const code = errorNode?.attrs.code ?? node.attrs.type ?? 'unknown';
@@ -30,6 +39,10 @@ function parseIqError(node) {
         ...(Number.isSafeInteger(parsedCode) ? { numericCode: parsedCode } : {})
     };
 }
+/**
+ * Throws when `node` is not a successful IQ result, embedding the parsed
+ * error envelope and the `context` label in the message.
+ */
 function assertIqResult(node, context) {
     if (node.tag !== constants_1.WA_NODE_TAGS.IQ) {
         throw new Error(`${context} returned non-iq node (${node.tag})`);
@@ -40,6 +53,10 @@ function assertIqResult(node, context) {
     const error = parseIqError(node);
     throw new Error(`${context} iq failed (${error.code}: ${error.text})`);
 }
+/**
+ * Wraps `query(...)` so failures are logged with a `context` label and the
+ * stanza's tag/id/type, then rethrown. Used by every coordinator's IQ call.
+ */
 async function queryWithContext(query, logger, context, node, timeoutMs, contextData = {}) {
     try {
         return await query(node, timeoutMs);

package/dist/transport/node/usync.js

@@ -1,8 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createUsyncSidGenerator = createUsyncSidGenerator;
+exports.logUsyncProtocolErrors = logUsyncProtocolErrors;
 const helpers_1 = require("./helpers");
 function createUsyncSidGenerator() {
     const generatorPromise = (0, helpers_1.createNodeIdGenerator)();
     return async () => (await generatorPromise).next();
 }
+function logUsyncProtocolErrors(envelope, logger, context) {
+    for (const protocol of Object.keys(envelope.errors)) {
+        const err = envelope.errors[protocol];
+        logger.warn('usync protocol error', {
+            context,
+            protocol,
+            code: err.code,
+            text: err.text,
+            backoffSeconds: err.backoffSeconds
+        });
+    }
+}