zapo-js 0.3.0 → 1.0.1

package/dist/esm/client/events/call.js

@@ -0,0 +1,55 @@
+import { WA_CALL_CHILD_TAGS, WA_CALL_NODE_ATTRS, WA_CALL_PAYLOAD_TAGS } from '../../protocol/call.js';
+import { findNodeChild, getFirstNodeChild, getNodeChildren, hasNodeChild } from '../../transport/node/helpers.js';
+import { parseOptionalInt } from '../../util/primitives.js';
+const KNOWN_CALL_PAYLOAD_TAGS = new Set(Object.values(WA_CALL_PAYLOAD_TAGS));
+function parseGroupInfo(node) {
+    const children = getNodeChildren(node);
+    if (children.length === 0) {
+        return undefined;
+    }
+    const out = [];
+    for (let i = 0; i < children.length; i += 1) {
+        const child = children[i];
+        const jid = child.attrs.jid;
+        if (!jid)
+            continue;
+        out.push({
+            jid,
+            userPnJid: child.attrs[WA_CALL_NODE_ATTRS.USER_PN],
+            username: child.attrs[WA_CALL_NODE_ATTRS.USERNAME],
+            guestName: child.attrs[WA_CALL_NODE_ATTRS.GUEST_NAME]
+        });
+    }
+    return out.length > 0 ? out : undefined;
+}
+export function parseCallNode(node) {
+    const payload = getFirstNodeChild(node);
+    if (!payload) {
+        return { type: 'unknown', isVideo: false };
+    }
+    const payloadTag = payload.tag;
+    const type = KNOWN_CALL_PAYLOAD_TAGS.has(payloadTag)
+        ? payloadTag
+        : 'unknown';
+    const groupInfoNode = findNodeChild(payload, WA_CALL_CHILD_TAGS.GROUP_INFO);
+    const silenceNode = findNodeChild(payload, WA_CALL_CHILD_TAGS.SILENCE);
+    return {
+        type,
+        payloadTag,
+        callId: payload.attrs[WA_CALL_NODE_ATTRS.CALL_ID],
+        callCreatorJid: payload.attrs[WA_CALL_NODE_ATTRS.CALL_CREATOR],
+        senderLidJid: node.attrs[WA_CALL_NODE_ATTRS.SENDER_LID],
+        callerPnJid: payload.attrs[WA_CALL_NODE_ATTRS.CALLER_PN],
+        groupJid: payload.attrs[WA_CALL_NODE_ATTRS.GROUP_JID],
+        isVideo: hasNodeChild(payload, WA_CALL_CHILD_TAGS.VIDEO),
+        callerUsername: payload.attrs[WA_CALL_NODE_ATTRS.USERNAME],
+        callerCountryCode: payload.attrs[WA_CALL_NODE_ATTRS.CALLER_COUNTRY_CODE],
+        callerPushName: payload.attrs[WA_CALL_NODE_ATTRS.NOTIFY],
+        peerPlatform: node.attrs[WA_CALL_NODE_ATTRS.PLATFORM],
+        peerAppVersion: node.attrs[WA_CALL_NODE_ATTRS.VERSION],
+        timestampSeconds: parseOptionalInt(node.attrs.t),
+        endTimestampSeconds: parseOptionalInt(node.attrs.e),
+        silenceReason: silenceNode?.attrs[WA_CALL_NODE_ATTRS.REASON],
+        groupInfo: groupInfoNode ? parseGroupInfo(groupInfoNode) : undefined
+    };
+}

package/dist/esm/client/events/chatstate.js

@@ -0,0 +1,20 @@
+import { WA_NODE_TAGS } from '../../protocol/nodes.js';
+import { WA_CHATSTATE_MEDIA } from '../../protocol/presence.js';
+import { getFirstNodeChild } from '../../transport/node/helpers.js';
+export function parseChatstateNode(node) {
+    const child = getFirstNodeChild(node);
+    if (!child) {
+        return null;
+    }
+    if (child.tag !== WA_NODE_TAGS.COMPOSING && child.tag !== WA_NODE_TAGS.PAUSED) {
+        return null;
+    }
+    const result = { state: child.tag };
+    if (child.tag === WA_NODE_TAGS.COMPOSING && child.attrs.media === WA_CHATSTATE_MEDIA.AUDIO) {
+        result.media = WA_CHATSTATE_MEDIA.AUDIO;
+    }
+    if (node.attrs.participant !== undefined) {
+        result.participantJid = node.attrs.participant;
+    }
+    return result;
+}

package/dist/esm/client/events/devices.js

@@ -1,5 +1,7 @@
 import { parseSignalAddressFromJid } from '../../protocol/jid.js';
+import { WA_NODE_TAGS } from '../../protocol/nodes.js';
 import { findNodeChild, getNodeChildrenByTag } from '../../transport/node/helpers.js';
+import { parseOptionalInt } from '../../util/primitives.js';
 export const DEVICE_NOTIFICATION_ACTIONS = Object.freeze({
     ADD: 'add',
     REMOVE: 'remove',
@@ -13,24 +15,27 @@ export function parseDeviceNotification(node) {
     }
     let action;
     let actionNode;
-    if (findNodeChild(node, DEVICE_NOTIFICATION_ACTIONS.REMOVE)) {
+    const removeNode = findNodeChild(node, DEVICE_NOTIFICATION_ACTIONS.REMOVE);
+    const addNode = removeNode ? undefined : findNodeChild(node, DEVICE_NOTIFICATION_ACTIONS.ADD);
+    const updateNode = removeNode || addNode ? undefined : findNodeChild(node, DEVICE_NOTIFICATION_ACTIONS.UPDATE);
+    if (removeNode) {
         action = DEVICE_NOTIFICATION_ACTIONS.REMOVE;
-        actionNode = findNodeChild(node, DEVICE_NOTIFICATION_ACTIONS.REMOVE);
+        actionNode = removeNode;
     }
-    else if (findNodeChild(node, DEVICE_NOTIFICATION_ACTIONS.ADD)) {
+    else if (addNode) {
         action = DEVICE_NOTIFICATION_ACTIONS.ADD;
-        actionNode = findNodeChild(node, DEVICE_NOTIFICATION_ACTIONS.ADD);
+        actionNode = addNode;
     }
-    else if (findNodeChild(node, DEVICE_NOTIFICATION_ACTIONS.UPDATE)) {
+    else if (updateNode) {
         action = DEVICE_NOTIFICATION_ACTIONS.UPDATE;
-        actionNode = findNodeChild(node, DEVICE_NOTIFICATION_ACTIONS.UPDATE);
+        actionNode = updateNode;
     }
     else {
         return null;
     }
     const devices = [];
     if (action !== DEVICE_NOTIFICATION_ACTIONS.UPDATE && actionNode) {
-        const deviceNodes = getNodeChildrenByTag(actionNode, 'device');
+        const deviceNodes = getNodeChildrenByTag(actionNode, WA_NODE_TAGS.DEVICE);
         for (let index = 0; index < deviceNodes.length; index += 1) {
             const deviceNode = deviceNodes[index];
             const jidAttr = deviceNode.attrs.jid;
@@ -44,13 +49,7 @@ export function parseDeviceNotification(node) {
             catch {
                 continue;
             }
-            const keyIndexAttr = deviceNode.attrs['key-index'];
-            const parsedKeyIndex = keyIndexAttr === undefined ? null : Number.parseInt(keyIndexAttr, 10);
-            const keyIndex = parsedKeyIndex !== null &&
-                Number.isSafeInteger(parsedKeyIndex) &&
-                parsedKeyIndex >= 0
-                ? parsedKeyIndex
-                : null;
+            const keyIndex = parseOptionalInt(deviceNode.attrs['key-index']) ?? null;
             devices[devices.length] = {
                 deviceId,
                 keyIndex
@@ -61,8 +60,8 @@ export function parseDeviceNotification(node) {
         action,
         stanzaId,
         fromJid,
-        lid: node.attrs.lid,
-        hash: action === DEVICE_NOTIFICATION_ACTIONS.UPDATE ? actionNode?.attrs.hash : undefined,
+        lid: node.attrs.lid ?? null,
+        hash: action === DEVICE_NOTIFICATION_ACTIONS.UPDATE ? (actionNode?.attrs.hash ?? null) : null,
         devices
     };
 }

package/dist/esm/client/{dirty.js → events/dirty.js}

@@ -1,15 +1,18 @@
-import { WA_ACCOUNT_SYNC_PROTOCOLS, WA_DEFAULTS, WA_DIRTY_PROTOCOLS, WA_DIRTY_TYPES, WA_IQ_TYPES, WA_SUPPORTED_DIRTY_TYPES } from '../protocol/constants.js';
-import { toUserJid } from '../protocol/jid.js';
-import { buildAccountBlocklistSyncIq, buildAccountDevicesSyncIq, buildAccountPictureSyncIq, buildAccountPrivacySyncIq, buildClearDirtyBitsIq, buildGroupsDirtySyncIq, buildNewsletterMetadataSyncIq } from '../transport/node/builders/account-sync.js';
-import { getNodeChildrenTags } from '../transport/node/helpers.js';
-import { assertIqResult, parseIqError } from '../transport/node/query.js';
-import { toError } from '../util/primitives.js';
+import { WA_ACCOUNT_SYNC_PROTOCOLS, WA_DEFAULTS, WA_DIRTY_PROTOCOLS, WA_DIRTY_TYPES, WA_IQ_TYPES, WA_NODE_TAGS, WA_SUPPORTED_DIRTY_TYPES } from '../../protocol/constants.js';
+import { toUserJid } from '../../protocol/jid.js';
+import { buildAccountBlocklistSyncIq, buildAccountDevicesSyncIq, buildAccountPictureSyncIq, buildClearDirtyBitsIq, buildListParticipatingGroupsIq, buildNewsletterMetadataSyncIq } from '../../transport/node/builders/account-sync.js';
+import { buildGetPrivacySettingsIq } from '../../transport/node/builders/privacy.js';
+import { parseUsyncResultEnvelope } from '../../transport/node/builders/usync.js';
+import { getNodeChildrenTags } from '../../transport/node/helpers.js';
+import { assertIqResult, parseIqError } from '../../transport/node/query.js';
+import { logUsyncProtocolErrors } from '../../transport/node/usync.js';
+import { parseOptionalInt, toError } from '../../util/primitives.js';
 const SUPPORTED_DIRTY_TYPES = new Set(WA_SUPPORTED_DIRTY_TYPES);
 const ACCOUNT_SYNC_PROTOCOL_SET = new Set(WA_ACCOUNT_SYNC_PROTOCOLS);
 function parseDirtyBitNode(node, logger) {
     const type = node.attrs.type;
-    const timestamp = Number.parseInt(node.attrs.timestamp ?? '', 10);
-    if (!type || !Number.isFinite(timestamp)) {
+    const timestamp = parseOptionalInt(node.attrs.timestamp);
+    if (!type || timestamp === undefined) {
         logger.warn('received invalid dirty bit node', {
             type,
             timestamp: node.attrs.timestamp
@@ -115,7 +118,7 @@ async function handleDirtyBit(runtime, dirtyBit) {
 }
 async function handleAccountSyncDirtyBit(runtime, protocols) {
     const selectedProtocols = resolveAccountSyncProtocols(protocols);
-    runtime.logger.info('received account_sync dirty bit', {
+    runtime.logger.debug('received account_sync dirty bit', {
         protocols: selectedProtocols.join(',')
     });
     const failures = [];
@@ -155,7 +158,7 @@ async function runAccountSyncProtocol(runtime, protocol) {
             await syncAccountBlocklistDirtyBit(runtime);
             return;
         case WA_DIRTY_PROTOCOLS.NOTICE:
-            runtime.logger.info('account_sync notice protocol received (no GraphQL/MEX job configured)');
+            runtime.logger.debug('account_sync notice protocol received (no GraphQL/MEX job configured)');
             return;
         default:
             runtime.logger.debug('unsupported account_sync protocol', {
@@ -164,19 +167,19 @@ async function runAccountSyncProtocol(runtime, protocol) {
     }
 }
 async function handleSyncdAppStateDirtyBit(runtime) {
-    runtime.logger.info('received syncd_app_state dirty bit, starting sync');
+    runtime.logger.debug('received syncd_app_state dirty bit, starting sync');
     await runtime.syncAppState();
 }
 async function syncAccountDevicesDirtyBit(runtime) {
     const credentials = runtime.getCurrentCredentials();
     const meJid = credentials?.meJid ?? null;
     if (!meJid) {
-        runtime.logger.warn('account_sync devices skipped: meJid is missing');
+        runtime.logger.trace('account_sync devices skipped: meJid is missing');
         return;
     }
     const userJids = resolveAccountSyncDeviceTargets(credentials);
     if (userJids.length === 0) {
-        runtime.logger.warn('account_sync devices skipped: no valid account_sync targets');
+        runtime.logger.trace('account_sync devices skipped: no valid account_sync targets');
         return;
     }
     await runSyncQuery(runtime, {
@@ -189,12 +192,12 @@ async function syncAccountDevicesDirtyBit(runtime) {
 async function syncAccountPictureDirtyBit(runtime) {
     const meJid = runtime.getCurrentCredentials()?.meJid ?? null;
     if (!meJid) {
-        runtime.logger.warn('account_sync picture skipped: meJid is missing');
+        runtime.logger.trace('account_sync picture skipped: meJid is missing');
         return;
     }
     const targetJid = toUserJid(meJid);
     const response = await runtime.queryWithContext('account_sync.picture', buildAccountPictureSyncIq(targetJid), WA_DEFAULTS.IQ_TIMEOUT_MS, { meJid, target: targetJid });
-    if (response.tag !== 'iq') {
+    if (response.tag !== WA_NODE_TAGS.IQ) {
         throw new Error(`account_sync.picture returned non-iq node (${response.tag})`);
     }
     if (response.attrs.type === WA_IQ_TYPES.RESULT) {
@@ -219,7 +222,7 @@ async function syncAccountPictureDirtyBit(runtime) {
 async function syncAccountPrivacyDirtyBit(runtime) {
     await runSyncQuery(runtime, {
         queryContext: 'account_sync.privacy',
-        node: buildAccountPrivacySyncIq(),
+        node: buildGetPrivacySettingsIq(),
         logMessage: 'account_sync privacy synchronized'
     });
 }
@@ -234,13 +237,23 @@ async function syncGroupsDirtyBit(runtime) {
     await runSyncQuery(runtime, {
         queryContext: 'dirty.groups',
         assertContext: 'groups',
-        node: buildGroupsDirtySyncIq(),
+        node: buildListParticipatingGroupsIq(),
         logMessage: 'groups dirty sync completed'
     });
 }
 async function syncNewsletterMetadataDirtyBit(runtime) {
-    runtime.logger.info('newsletter_metadata dirty bit received (GraphQL/MEX sync intentionally disabled)');
     await runtime.queryWithContext('dirty.newsletter_metadata', buildNewsletterMetadataSyncIq(), WA_DEFAULTS.IQ_TIMEOUT_MS);
+    if (runtime.newsletterListSubscribed) {
+        try {
+            await runtime.newsletterListSubscribed();
+        }
+        catch (error) {
+            runtime.logger.warn('newsletter_metadata MEX sync failed', {
+                message: toError(error).message
+            });
+            throw error;
+        }
+    }
 }
 function resolveAccountSyncDeviceTargets(credentials) {
     if (!credentials?.meJid) {
@@ -256,6 +269,7 @@ function resolveAccountSyncDeviceTargets(credentials) {
 async function runSyncQuery(runtime, args) {
     const response = await runtime.queryWithContext(args.queryContext, args.node, WA_DEFAULTS.IQ_TIMEOUT_MS, args.contextData);
     assertIqResult(response, args.assertContext ?? args.queryContext);
+    logUsyncProtocolErrors(parseUsyncResultEnvelope(response), runtime.logger, args.queryContext);
     runtime.logger.debug(args.logMessage, args.contextData);
 }
 async function clearDirtyBits(runtime, dirtyBits) {
@@ -263,7 +277,7 @@ async function clearDirtyBits(runtime, dirtyBits) {
         await runtime.queryWithContext('dirty.clear', buildClearDirtyBitsIq(dirtyBits), WA_DEFAULTS.IQ_TIMEOUT_MS, {
             count: dirtyBits.length
         }, { useSystemId: true });
-        runtime.logger.info('dirty bits cleared', {
+        runtime.logger.debug('dirty bits cleared', {
             count: dirtyBits.length
         });
     }

package/dist/esm/client/events/group.js

@@ -1,21 +1,8 @@
-import { createUnhandledIncomingNodeEvent } from '../incoming.js';
+import { createUnhandledIncomingNodeEvent } from '../events/incoming.js';
 import { WA_GROUP_NOTIFICATION_TAGS, WA_NOTIFICATION_TYPES } from '../../protocol/constants.js';
 import { WA_NODE_TAGS } from '../../protocol/nodes.js';
-import { findNodeChild, getNodeChildren, getNodeChildrenByTag } from '../../transport/node/helpers.js';
-import { TEXT_DECODER } from '../../util/bytes.js';
+import { findNodeChild, getNodeChildren, getNodeChildrenByTag, getNodeTextContent } from '../../transport/node/helpers.js';
 import { parseOptionalInt } from '../../util/primitives.js';
-function readNodeTextContent(node) {
-    if (!node) {
-        return undefined;
-    }
-    if (typeof node.content === 'string') {
-        return node.content;
-    }
-    if (node.content instanceof Uint8Array) {
-        return TEXT_DECODER.decode(node.content);
-    }
-    return undefined;
-}
 export function parseParticipants(node) {
     const participants = [];
     for (const participantNode of getNodeChildrenByTag(node, WA_NODE_TAGS.PARTICIPANT)) {
@@ -65,14 +52,14 @@ function parseSubgroupSuggestion(node) {
     return {
         groupJid: node.attrs.jid,
         ownerJid: node.attrs.creator,
-        subject: readNodeTextContent(subjectNode),
-        description: readNodeTextContent(descriptionBodyNode),
+        subject: getNodeTextContent(subjectNode),
+        description: getNodeTextContent(descriptionBodyNode),
         timestampSeconds: parseOptionalInt(node.attrs.creation),
-        isExistingGroup: readNodeTextContent(isExistingGroupNode) === undefined
+        isExistingGroup: getNodeTextContent(isExistingGroupNode) === undefined
             ? undefined
-            : readNodeTextContent(isExistingGroupNode) === 'true',
+            : getNodeTextContent(isExistingGroupNode) === 'true',
         participantCount: participantCountNode
-            ? parseOptionalInt(readNodeTextContent(participantCountNode))
+            ? parseOptionalInt(getNodeTextContent(participantCountNode))
             : undefined,
         reason: node.attrs.reason
     };
@@ -95,6 +82,7 @@ function createBaseGroupEvent(notificationNode, actionNode) {
         stanzaId: notificationNode.attrs.id,
         chatJid: notificationNode.attrs.from,
         stanzaType: notificationNode.attrs.type,
+        offline: notificationNode.attrs.offline !== undefined,
         groupJid: notificationNode.attrs.from,
         authorJid: notificationNode.attrs.participant,
         timestampSeconds: parseOptionalInt(notificationNode.attrs.t)
@@ -119,7 +107,7 @@ function parseCreateGroupAction(notificationNode, actionNode) {
         participants: parseParticipants(groupNode),
         subject: groupNode.attrs.subject,
         subjectOwnerJid: groupNode.attrs.s_o,
-        description: readNodeTextContent(descriptionBodyNode),
+        description: getNodeTextContent(descriptionBodyNode),
         descriptionId: descriptionNode?.attrs.id,
         reason: actionNode.attrs.reason,
         contextGroupJid: actionNode.attrs.context_group_jid,
@@ -138,7 +126,8 @@ function parseCreateGroupAction(notificationNode, actionNode) {
             defaultSubgroup: findNodeChild(groupNode, 'default_sub_group') !== undefined,
             generalSubgroup: findNodeChild(groupNode, 'general_chat') !== undefined,
             hiddenSubgroup: findNodeChild(groupNode, 'hidden_group') !== undefined,
-            groupSafetyCheck: findNodeChild(groupNode, 'group_safety_check') !== undefined,
+            groupSafetyCheck: findNodeChild(groupNode, WA_GROUP_NOTIFICATION_TAGS.GROUP_SAFETY_CHECK) !==
+                undefined,
             hasCapi: findNodeChild(groupNode, 'capi') !== undefined,
             limitSharingEnabled: findNodeChild(groupNode, WA_GROUP_NOTIFICATION_TAGS.LIMIT_SHARING_ENABLED) !==
                 undefined,
@@ -222,12 +211,12 @@ function parseGroupActionNode(notificationNode, actionNode) {
                 }
             };
         case WA_GROUP_NOTIFICATION_TAGS.DESCRIPTION: {
-            const hasDeleteChild = findNodeChild(actionNode, 'delete') !== undefined;
+            const hasDeleteChild = findNodeChild(actionNode, WA_GROUP_NOTIFICATION_TAGS.DELETE) !== undefined;
             const bodyNode = findNodeChild(actionNode, WA_NODE_TAGS.BODY);
             return {
                 ...baseEvent,
                 action: 'description',
-                description: hasDeleteChild ? undefined : readNodeTextContent(bodyNode),
+                description: hasDeleteChild ? undefined : getNodeTextContent(bodyNode),
                 descriptionId: actionNode.attrs.id,
                 enabled: !hasDeleteChild
             };
@@ -375,7 +364,7 @@ function parseGroupActionNode(notificationNode, actionNode) {
             return {
                 ...baseEvent,
                 action: 'member_add_mode',
-                mode: readNodeTextContent(actionNode)
+                mode: getNodeTextContent(actionNode)
             };
         case WA_GROUP_NOTIFICATION_TAGS.AUTO_ADD_DISABLED:
             return { ...baseEvent, action: 'auto_add_disabled', enabled: true };

package/dist/esm/client/events/identity.js

@@ -1,7 +1,8 @@
+import { WA_NODE_TAGS } from '../../protocol/nodes.js';
 import { getFirstNodeChild } from '../../transport/node/helpers.js';
 export function parseIdentityChangeNotification(node) {
     const child = getFirstNodeChild(node);
-    if (!child || child.tag !== 'identity') {
+    if (!child || child.tag !== WA_NODE_TAGS.IDENTITY) {
         return null;
     }
     const fromJid = node.attrs.from;