zapo-js 0.3.0 → 1.0.0

package/dist/client/coordinators/WaNewsletterCoordinator.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseNewsletterMetadata = void 0;
+exports.createNewsletterCoordinator = createNewsletterCoordinator;
+const admin_1 = require("../newsletter/admin");
+const discovery_1 = require("../newsletter/discovery");
+const messaging_1 = require("../newsletter/messaging");
+var parse_1 = require("../newsletter/parse");
+Object.defineProperty(exports, "parseNewsletterMetadata", { enumerable: true, get: function () { return parse_1.parseNewsletterMetadata; } });
+/** Builds a {@link WaNewsletterCoordinator} from its MEX/messaging dependencies. */
+function createNewsletterCoordinator(options) {
+    const mexDeps = options;
+    return {
+        ...(0, discovery_1.createDiscoveryOps)(mexDeps),
+        ...(0, admin_1.createAdminOps)(mexDeps),
+        ...(0, messaging_1.createMessagingOps)(options)
+    };
+}

package/dist/client/coordinators/WaPassiveTasksCoordinator.js

@@ -5,6 +5,7 @@ const constants_1 = require("../../protocol/constants");
 const constants_2 = require("../../signal/api/constants");
 const prekeys_1 = require("../../signal/api/prekeys");
 const keygen_1 = require("../../signal/registration/keygen");
+const passive_1 = require("../../transport/node/builders/passive");
 const primitives_1 = require("../../util/primitives");
 class WaPassiveTasksCoordinator {
     constructor(options) {
@@ -55,7 +56,7 @@ class WaPassiveTasksCoordinator {
     }
     async runPassiveTasksAfterConnect() {
         const credentials = this.runtime.getCurrentCredentials();
-        const isRegistered = credentials?.meJid !== null && credentials?.meJid !== undefined;
+        const isRegistered = !!credentials?.meJid;
         if (!isRegistered) {
             this.logger.trace('passive connect tasks skipped: session is not registered');
             return;
@@ -68,8 +69,8 @@ class WaPassiveTasksCoordinator {
                 });
             });
         }
-        await this.runtime.sendPresenceAvailable().catch((error) => {
-            this.logger.warn('presence available send failed', {
+        await this.runtime.sendInitialPresence().catch((error) => {
+            this.logger.warn('initial presence send failed', {
                 message: (0, primitives_1.toError)(error).message
             });
         });
@@ -84,6 +85,17 @@ class WaPassiveTasksCoordinator {
         await this.validateDigestAndRecoverPreKeys(prefetchedLocalKeyBundle);
         await this.rotateSignedPreKeyIfDue(signedPreKeyRotationTs);
         await this.flushDanglingReceipts();
+        await this.sendActiveModeIq();
+    }
+    async sendActiveModeIq() {
+        try {
+            await this.runtime.queryWithContext('passive.active', (0, passive_1.buildPassiveModeIqNode)('active'), constants_1.WA_DEFAULTS.IQ_TIMEOUT_MS);
+        }
+        catch (error) {
+            this.logger.warn('passive active iq failed', {
+                message: (0, primitives_1.toError)(error).message
+            });
+        }
     }
     async validateDigestAndRecoverPreKeys(prefetchedLocalKeyBundle) {
         try {
@@ -138,7 +150,7 @@ class WaPassiveTasksCoordinator {
             count: preKeys.length,
             lastPreKeyId
         }, this.mobilePrimary ? { useSystemId: true } : undefined);
-        if (response.attrs.type === 'result') {
+        if (response.attrs.type === constants_1.WA_IQ_TYPES.RESULT) {
             // Mark uploaded key first so the serverHasPreKeys flag never commits ahead of local key progress.
             await this.preKeyStore.markKeyAsUploaded(lastPreKeyId);
             await Promise.all([
@@ -154,6 +166,7 @@ class WaPassiveTasksCoordinator {
         const failure = (0, prekeys_1.parsePreKeyUploadFailure)(response);
         this.logger.warn('upload prekeys failed', {
             count: preKeys.length,
+            lastPreKeyId,
             errorCode: failure.errorCode,
             errorText: failure.errorText
         });

package/dist/client/coordinators/WaPresenceCoordinator.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPresenceCoordinator = createPresenceCoordinator;
+const chatstate_1 = require("../../transport/node/builders/chatstate");
+const presence_1 = require("../../transport/node/builders/presence");
+/** Builds a {@link WaPresenceCoordinator} from its node-send dependency. */
+function createPresenceCoordinator(options) {
+    const { sendNode, getCurrentCredentials } = options;
+    return {
+        send: async (type) => {
+            const credentials = getCurrentCredentials();
+            await sendNode((0, presence_1.buildPresenceNode)({ type, name: credentials?.meDisplayName ?? undefined }));
+        },
+        sendChatstate: async (jid, opts) => {
+            await sendNode((0, chatstate_1.buildChatstateNode)({ jid, ...opts }));
+        },
+        subscribe: async (jid, opts) => {
+            await sendNode((0, presence_1.buildPresenceSubscribeNode)({ jid, ...opts }));
+        }
+    };
+}

package/dist/client/coordinators/WaPrivacyCoordinator.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createPrivacyCoordinator = createPrivacyCoordinator;
+const nodes_1 = require("../../protocol/nodes");
 const privacy_1 = require("../../protocol/privacy");
 const privacy_2 = require("../../transport/node/builders/privacy");
 const helpers_1 = require("../../transport/node/helpers");
@@ -14,12 +15,12 @@ const IGNORED_SERVER_CATEGORIES = new Set([
     'dependent_account_calling',
     'groupcreation'
 ]);
+const VALID_PRIVACY_VALUES = new Set(Object.values(privacy_1.WA_PRIVACY_VALUES));
 function isValidPrivacyValue(value) {
-    return (value !== privacy_1.WA_PRIVACY_VALUES.ERROR &&
-        Object.values(privacy_1.WA_PRIVACY_VALUES).includes(value));
+    return value !== privacy_1.WA_PRIVACY_VALUES.ERROR && VALID_PRIVACY_VALUES.has(value);
 }
 function parsePrivacySettings(result) {
-    const privacyNode = (0, helpers_1.findNodeChild)(result, 'privacy');
+    const privacyNode = (0, helpers_1.findNodeChild)(result, nodes_1.WA_NODE_TAGS.PRIVACY);
     if (!privacyNode) {
         return {};
     }
@@ -46,7 +47,7 @@ function parsePrivacySettings(result) {
     return settings;
 }
 function parseDisallowedList(result) {
-    const privacyNode = (0, helpers_1.findNodeChild)(result, 'privacy');
+    const privacyNode = (0, helpers_1.findNodeChild)(result, nodes_1.WA_NODE_TAGS.PRIVACY);
     if (!privacyNode) {
         return { jids: [] };
     }
@@ -69,7 +70,7 @@ function parseDisallowedList(result) {
     return { jids, dhash };
 }
 function parseBlocklist(result) {
-    const listNode = (0, helpers_1.findNodeChild)(result, 'list');
+    const listNode = (0, helpers_1.findNodeChild)(result, nodes_1.WA_NODE_TAGS.LIST);
     if (!listNode) {
         return { jids: [] };
     }
@@ -87,6 +88,7 @@ function parseBlocklist(result) {
     jids.length = jidsCount;
     return { jids, dhash };
 }
+/** Builds a {@link WaPrivacyCoordinator} backed by the given IQ query function. */
 function createPrivacyCoordinator(options) {
     const { queryWithContext } = options;
     return {

package/dist/client/coordinators/WaProfileCoordinator.js

@@ -1,13 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createProfileCoordinator = createProfileCoordinator;
+const jid_1 = require("../../protocol/jid");
+const nodes_1 = require("../../protocol/nodes");
 const profile_1 = require("../../transport/node/builders/profile");
 const usync_1 = require("../../transport/node/builders/usync");
 const helpers_1 = require("../../transport/node/helpers");
+const client_1 = require("../../transport/node/mex/client");
 const query_1 = require("../../transport/node/query");
-const bytes_1 = require("../../util/bytes");
+const usync_2 = require("../../transport/node/usync");
+const coercion_1 = require("../../util/coercion");
+const primitives_1 = require("../../util/primitives");
 function parseProfilePicture(result) {
-    const pictureNode = (0, helpers_1.findNodeChild)(result, 'picture');
+    const pictureNode = (0, helpers_1.findNodeChild)(result, nodes_1.WA_NODE_TAGS.PICTURE);
     if (!pictureNode) {
         return {};
     }
@@ -19,26 +24,15 @@ function parseProfilePicture(result) {
     };
 }
 function parseSetPictureResult(result) {
-    const pictureNode = (0, helpers_1.findNodeChild)(result, 'picture');
+    const pictureNode = (0, helpers_1.findNodeChild)(result, nodes_1.WA_NODE_TAGS.PICTURE);
     return pictureNode?.attrs.id ?? null;
 }
 function parseUsyncProfiles(result) {
-    const usyncNode = (0, helpers_1.findNodeChild)(result, 'usync');
-    if (!usyncNode) {
-        return [];
-    }
-    const listNode = (0, helpers_1.findNodeChild)(usyncNode, 'list');
-    if (!listNode) {
-        return [];
-    }
-    const userNodes = (0, helpers_1.getNodeChildren)(listNode);
+    const userNodes = (0, usync_1.iterateUsyncUsers)(result) ?? [];
     const profiles = new Array(userNodes.length);
     let count = 0;
     for (let i = 0; i < userNodes.length; i += 1) {
         const userNode = userNodes[i];
-        if (userNode.tag !== 'user') {
-            continue;
-        }
         const jid = userNode.attrs.jid;
         if (!jid) {
             continue;
@@ -52,32 +46,19 @@ function parseUsyncProfiles(result) {
         }
         for (let j = 0; j < userContent.length; j += 1) {
             const child = userContent[j];
-            if (child.tag === 'picture') {
-                const idAttr = child.attrs.id;
-                if (idAttr) {
-                    const parsed = Number.parseInt(idAttr, 10);
-                    if (Number.isSafeInteger(parsed)) {
-                        info.pictureId = parsed;
-                    }
+            if (child.tag === nodes_1.WA_NODE_TAGS.PICTURE) {
+                const pictureId = (0, primitives_1.parseOptionalInt)(child.attrs.id);
+                if (pictureId !== undefined) {
+                    info.pictureId = pictureId;
                 }
             }
-            else if (child.tag === 'status') {
+            else if (child.tag === nodes_1.WA_NODE_TAGS.STATUS) {
                 const code = child.attrs.code;
-                if (code !== undefined && Number.parseInt(code, 10) === 401) {
+                if ((0, primitives_1.parseOptionalInt)(code) === 401) {
                     info.status = '';
                 }
                 else {
-                    const content = child.content;
-                    if (content instanceof Uint8Array) {
-                        const decoded = bytes_1.TEXT_DECODER.decode(content);
-                        info.status = decoded.length > 0 ? decoded : null;
-                    }
-                    else if (typeof content === 'string') {
-                        info.status = content.length > 0 ? content : null;
-                    }
-                    else {
-                        info.status = null;
-                    }
+                    info.status = (0, helpers_1.getNodeTextContent)(child) || null;
                 }
             }
         }
@@ -88,31 +69,23 @@ function parseUsyncProfiles(result) {
     return profiles;
 }
 function parseUsyncDisappearingModes(result) {
-    const usyncNode = (0, helpers_1.findNodeChild)(result, 'usync');
-    if (!usyncNode)
-        return [];
-    const listNode = (0, helpers_1.findNodeChild)(usyncNode, 'list');
-    if (!listNode)
-        return [];
-    const userNodes = (0, helpers_1.getNodeChildren)(listNode);
+    const userNodes = (0, usync_1.iterateUsyncUsers)(result) ?? [];
     const results = new Array(userNodes.length);
     let count = 0;
     for (let i = 0; i < userNodes.length; i += 1) {
         const userNode = userNodes[i];
-        if (userNode.tag !== 'user')
-            continue;
         const userContent = userNode.content;
         if (!Array.isArray(userContent))
             continue;
         for (let j = 0; j < userContent.length; j += 1) {
             const child = userContent[j];
-            if (child.tag !== 'disappearing_mode')
+            if (child.tag !== nodes_1.WA_NODE_TAGS.DISAPPEARING_MODE)
                 continue;
-            const errorNode = (0, helpers_1.findNodeChild)(child, 'error');
+            const errorNode = (0, helpers_1.findNodeChild)(child, nodes_1.WA_NODE_TAGS.ERROR);
             if (errorNode)
                 continue;
-            const duration = Number.parseInt(child.attrs.duration ?? '0', 10);
-            const timestamp = Number.parseInt(child.attrs.t ?? '0', 10);
+            const duration = (0, primitives_1.parseOptionalInt)(child.attrs.duration) ?? 0;
+            const timestamp = (0, primitives_1.parseOptionalInt)(child.attrs.t) ?? 0;
             const entry = { duration, timestamp };
             if (child.attrs.ephemerality_disabled === 'true') {
                 entry.ephemeralityDisabled = true;
@@ -124,6 +97,82 @@ function parseUsyncDisappearingModes(result) {
     results.length = count;
     return results;
 }
+function parseUsyncTextStatuses(result) {
+    const userNodes = (0, usync_1.iterateUsyncUsers)(result) ?? [];
+    const results = new Array(userNodes.length);
+    let count = 0;
+    for (let i = 0; i < userNodes.length; i += 1) {
+        const userNode = userNodes[i];
+        const jid = userNode.attrs.jid;
+        if (!jid)
+            continue;
+        let entry = {
+            jid,
+            text: null,
+            emoji: null,
+            ephemeralDurationSec: null,
+            lastUpdateTime: null
+        };
+        const textStatusNode = (0, helpers_1.findNodeChild)(userNode, nodes_1.WA_NODE_TAGS.TEXT_STATUS);
+        if (textStatusNode && !(0, helpers_1.findNodeChild)(textStatusNode, nodes_1.WA_NODE_TAGS.ERROR)) {
+            const emojiNode = (0, helpers_1.findNodeChild)(textStatusNode, 'emoji');
+            entry = {
+                jid,
+                text: textStatusNode.attrs.text ?? null,
+                emoji: emojiNode?.attrs.content ?? null,
+                ephemeralDurationSec: (0, primitives_1.parseOptionalSignedInt)(textStatusNode.attrs.ephemeral_duration_sec) ?? null,
+                lastUpdateTime: (0, primitives_1.parseOptionalInt)(textStatusNode.attrs.last_update_time) ?? null
+            };
+        }
+        results[count] = entry;
+        count += 1;
+    }
+    results.length = count;
+    return results;
+}
+function parseUsyncUsernames(result) {
+    const userNodes = (0, usync_1.iterateUsyncUsers)(result) ?? [];
+    const results = new Array(userNodes.length);
+    let count = 0;
+    for (let i = 0; i < userNodes.length; i += 1) {
+        const userNode = userNodes[i];
+        const jid = userNode.attrs.jid;
+        if (!jid)
+            continue;
+        const usernameNode = (0, helpers_1.findNodeChild)(userNode, nodes_1.WA_NODE_TAGS.USERNAME);
+        const hasUsernameError = usernameNode && (0, helpers_1.findNodeChild)(usernameNode, nodes_1.WA_NODE_TAGS.ERROR) !== undefined;
+        const username = usernameNode && !hasUsernameError ? (0, helpers_1.getNodeTextContent)(usernameNode) || null : null;
+        results[count] = { jid, username };
+        count += 1;
+    }
+    results.length = count;
+    return results;
+}
+function parseOwnUsernameMexResponse(data) {
+    const info = (0, coercion_1.tryAsRecord)((0, coercion_1.tryAsRecord)(data?.xwa2_username_get)?.username_info);
+    return {
+        username: (0, coercion_1.tryAsString)(info?.username),
+        state: (0, coercion_1.tryAsString)(info?.state),
+        pin: (0, coercion_1.tryAsString)(info?.pin)
+    };
+}
+function isMexSetUsernameSuccess(data) {
+    return data?.xwa2_username_set?.result === 'SUCCESS';
+}
+function parseAboutStatusMexResponse(data) {
+    return data?.xwa2_users_updates_since?.[0]?.updates?.[0]?.text ?? null;
+}
+function parseUsernameAvailabilityMexResponse(data) {
+    const check = data?.xwa2_username_check;
+    const suggestions = (Array.isArray(check?.suggestions) ? check.suggestions : []).filter((s) => typeof s === 'string');
+    return { available: check?.result === 'SUCCESS', suggestions };
+}
+function isMexUsernameKeySetSuccess(data) {
+    return data?.xwa2_username_pin_set?.result === 'SUCCESS';
+}
+function isMexNotFoundError(error) {
+    return error instanceof Error && /\berrors?:\s*404\b/.test(error.message);
+}
 function parseUsyncStatus(result) {
     const profiles = parseUsyncProfiles(result);
     if (profiles.length === 0) {
@@ -131,8 +180,22 @@ function parseUsyncStatus(result) {
     }
     return { status: profiles[0].status ?? null };
 }
+function buildTextStatusMutationInput(input) {
+    const text = input.text === '' ? null : (input.text ?? null);
+    const emoji = input.emoji ?? null;
+    let ephemeralDurationSec = input.ephemeralDurationSec ?? 0;
+    if (text === null && emoji === null && ephemeralDurationSec !== 0) {
+        ephemeralDurationSec = 0;
+    }
+    return {
+        text,
+        emoji: emoji !== null ? { content: emoji } : undefined,
+        ephemeral_duration_sec: ephemeralDurationSec
+    };
+}
+/** Builds a {@link WaProfileCoordinator} from its IQ/MEX/SID dependencies. */
 function createProfileCoordinator(options) {
-    const { queryWithContext, generateSid } = options;
+    const { queryWithContext, generateSid, mexSocket, queryLidsByPhoneJids, mutations, logger } = options;
     return {
         getProfilePicture: async (jid, type, existingId) => {
             const node = (0, profile_1.buildGetProfilePictureIq)(jid, type, existingId);
@@ -171,6 +234,7 @@ function createProfileCoordinator(options) {
                 jid
             });
             (0, query_1.assertIqResult)(result, 'profile.getStatus');
+            (0, usync_2.logUsyncProtocolErrors)((0, usync_1.parseUsyncResultEnvelope)(result), logger, 'profile.getStatus');
             return parseUsyncStatus(result);
         },
         setStatus: async (text) => {
@@ -180,6 +244,9 @@ function createProfileCoordinator(options) {
             });
             (0, query_1.assertIqResult)(result, 'profile.setStatus');
         },
+        setPushName: async (name) => {
+            await mutations.set({ schema: 'SettingPushName', name });
+        },
         getProfiles: async (jids) => {
             if (jids.length === 0) {
                 return [];
@@ -195,6 +262,7 @@ function createProfileCoordinator(options) {
                 count: jids.length
             });
             (0, query_1.assertIqResult)(result, 'profile.getProfiles');
+            (0, usync_2.logUsyncProtocolErrors)((0, usync_1.parseUsyncResultEnvelope)(result), logger, 'profile.getProfiles');
             return parseUsyncProfiles(result);
         },
         getDisappearingMode: async (jids) => {
@@ -208,7 +276,110 @@ function createProfileCoordinator(options) {
             });
             const result = await queryWithContext('profile.getDisappearingMode', usyncNode, undefined, { count: jids.length });
             (0, query_1.assertIqResult)(result, 'profile.getDisappearingMode');
+            (0, usync_2.logUsyncProtocolErrors)((0, usync_1.parseUsyncResultEnvelope)(result), logger, 'profile.getDisappearingMode');
             return parseUsyncDisappearingModes(result);
+        },
+        setDisappearingMode: async (durationSeconds) => {
+            if (!Number.isFinite(durationSeconds) ||
+                !Number.isSafeInteger(durationSeconds) ||
+                durationSeconds < 0) {
+                throw new Error(`invalid durationSeconds: ${durationSeconds}`);
+            }
+            const node = (0, profile_1.buildSetDisappearingModeIq)(durationSeconds);
+            const result = await queryWithContext('profile.setDisappearingMode', node, undefined, {
+                durationSeconds
+            });
+            (0, query_1.assertIqResult)(result, 'profile.setDisappearingMode');
+        },
+        getTextStatuses: async (jids) => {
+            if (jids.length === 0)
+                return [];
+            const sid = await generateSid();
+            const usyncNode = (0, usync_1.buildUsyncIq)({
+                sid,
+                queryProtocolNodes: [(0, profile_1.buildGetTextStatusUsyncQueryNode)()],
+                users: jids.map((jid) => ({ jid }))
+            });
+            const result = await queryWithContext('profile.getTextStatuses', usyncNode, undefined, {
+                count: jids.length
+            });
+            (0, query_1.assertIqResult)(result, 'profile.getTextStatuses');
+            (0, usync_2.logUsyncProtocolErrors)((0, usync_1.parseUsyncResultEnvelope)(result), logger, 'profile.getTextStatuses');
+            return parseUsyncTextStatuses(result);
+        },
+        setTextStatus: async (input) => {
+            await (0, client_1.runMexQuery)(mexSocket, 'UpdateTextStatus', {
+                input: buildTextStatusMutationInput(input)
+            });
+        },
+        getUsernames: async (jids) => {
+            if (jids.length === 0)
+                return [];
+            const sid = await generateSid();
+            const usyncNode = (0, usync_1.buildUsyncIq)({
+                sid,
+                queryProtocolNodes: [(0, profile_1.buildGetUsernameUsyncQueryNode)()],
+                users: jids.map((jid) => ({ jid }))
+            });
+            const result = await queryWithContext('profile.getUsernames', usyncNode, undefined, {
+                count: jids.length
+            });
+            (0, query_1.assertIqResult)(result, 'profile.getUsernames');
+            (0, usync_2.logUsyncProtocolErrors)((0, usync_1.parseUsyncResultEnvelope)(result), logger, 'profile.getUsernames');
+            return parseUsyncUsernames(result);
+        },
+        getOwnUsername: async () => {
+            try {
+                const data = await (0, client_1.runMexQuery)(mexSocket, 'GetUsername', {});
+                return parseOwnUsernameMexResponse(data);
+            }
+            catch (error) {
+                if (isMexNotFoundError(error)) {
+                    return { username: null, state: null, pin: null };
+                }
+                throw error;
+            }
+        },
+        setUsername: async (input) => {
+            const data = await (0, client_1.runMexQuery)(mexSocket, 'SetUsername', {
+                input: input.username,
+                reserved: input.reserved ?? false,
+                session_id: input.sessionId ?? '',
+                source: input.source ?? 'USER_INPUT'
+            });
+            return isMexSetUsernameSuccess(data);
+        },
+        deleteUsername: async () => {
+            const data = await (0, client_1.runMexQuery)(mexSocket, 'SetUsername', {});
+            return isMexSetUsernameSuccess(data);
+        },
+        getAboutStatus: async (jid) => {
+            const data = await (0, client_1.runMexQuery)(mexSocket, 'FetchAboutStatus', {
+                user: { user_id: (0, jid_1.parseJidFull)(jid).address.user }
+            });
+            return parseAboutStatusMexResponse(data);
+        },
+        checkUsernameAvailability: async (username) => {
+            const data = await (0, client_1.runMexQuery)(mexSocket, 'UsernameAvailability', {
+                input: username
+            });
+            return parseUsernameAvailabilityMexResponse(data);
+        },
+        setUsernameKey: async (pin) => {
+            const data = await (0, client_1.runMexQuery)(mexSocket, 'SetUsernameKey', { pin });
+            return isMexUsernameKeySetSuccess(data);
+        },
+        getLidsByPhoneNumbers: async (phoneNumbers) => {
+            if (phoneNumbers.length === 0)
+                return [];
+            const normalizedPhoneJids = new Array(phoneNumbers.length);
+            for (let index = 0; index < phoneNumbers.length; index += 1) {
+                normalizedPhoneJids[index] = (0, jid_1.parsePhoneJid)(phoneNumbers[index]);
+            }
+            logger.trace('profile.getLidsByPhoneNumbers', {
+                phones: normalizedPhoneJids.length
+            });
+            return queryLidsByPhoneJids(normalizedPhoneJids);
         }
     };
 }