zapo-js 0.2.0 → 0.3.0

package/dist/transport/node/WaMobileTcpSocket.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WaMobileTcpSocketCtor = exports.WaMobileTcpSocket = void 0;
+const node_net_1 = require("node:net");
+const constants_1 = require("../../protocol/constants");
+const bytes_1 = require("../../util/bytes");
+class WaMobileTcpSocket {
+    constructor(url, _protocols, _options) {
+        this.binaryType = 'arraybuffer';
+        this.readyState = constants_1.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 = (0, node_net_1.connect)({ host, port });
+        this.socket.on('connect', () => {
+            if (this.readyState !== constants_1.WA_READY_STATES.CONNECTING)
+                return;
+            this.readyState = constants_1.WA_READY_STATES.OPEN;
+            this.onopen?.({});
+        });
+        this.socket.on('data', (chunk) => {
+            if (!this.onmessage || this.readyState !== constants_1.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 = constants_1.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 !== constants_1.WA_READY_STATES.OPEN) {
+            throw new Error('WaMobileTcpSocket: send() called on non-OPEN socket');
+        }
+        let bytes;
+        if (typeof data === 'string') {
+            bytes = bytes_1.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 === constants_1.WA_READY_STATES.CLOSED)
+            return;
+        this.readyState = constants_1.WA_READY_STATES.CLOSING;
+        this.closedCode = code ?? 1000;
+        this.closedReason = reason ?? '';
+        this.socket.end();
+        this.forceCloseTimer = setTimeout(() => {
+            this.forceCloseTimer = null;
+            if (this.readyState !== constants_1.WA_READY_STATES.CLOSED) {
+                this.socket.destroy();
+            }
+        }, 5000);
+        this.forceCloseTimer.unref();
+    }
+}
+exports.WaMobileTcpSocket = WaMobileTcpSocket;
+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 };
+}
+exports.WaMobileTcpSocketCtor = WaMobileTcpSocket;

package/dist/transport/node/WaNodeOrchestrator.js

@@ -10,6 +10,7 @@ class WaNodeOrchestrator {
         this.sendNodeFn = options.sendNode;
         this.defaultTimeoutMs = options.defaultTimeoutMs ?? constants_1.WA_DEFAULTS.NODE_QUERY_TIMEOUT_MS;
         this.hostDomain = options.hostDomain ?? constants_1.WA_DEFAULTS.HOST_DOMAIN;
+        this.mobileIqIdFormat = options.mobileIqIdFormat === true;
         this.idGenerator = null;
         this.idGeneratorReady = null;
         this.pendingQueries = new Map();
@@ -72,12 +73,12 @@ 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');
@@ -113,12 +114,13 @@ class WaNodeOrchestrator {
             });
         });
     }
-    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: {
@@ -131,6 +133,13 @@ class WaNodeOrchestrator {
         if (this.idGenerator) {
             return this.idGenerator;
         }
+        if (this.mobileIqIdFormat) {
+            this.idGenerator = (0, helpers_1.createMobileNodeIdGenerator)();
+            this.logger.debug('generated stanza prefix (mobile)', {
+                prefix: this.idGenerator.prefix
+            });
+            return this.idGenerator;
+        }
         if (!this.idGeneratorReady) {
             this.idGeneratorReady = (0, helpers_1.createNodeIdGenerator)();
         }

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildGetAbPropsIq = buildGetAbPropsIq;
+const abprops_1 = require("../../../protocol/abprops");
+const constants_1 = require("../../../protocol/constants");
+const query_1 = require("../../node/query");
+function buildGetAbPropsIq(options) {
+    const propsAttrs = {
+        protocol: abprops_1.WA_ABPROPS_PROTOCOL_VERSION
+    };
+    if (options?.hash) {
+        propsAttrs.hash = options.hash;
+    }
+    if (options?.refreshId !== undefined && options.refreshId !== null) {
+        propsAttrs.refresh_id = `${options.refreshId}`;
+    }
+    return (0, query_1.buildIqNode)('get', constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.ABPROPS, [
+        {
+            tag: 'props',
+            attrs: propsAttrs
+        }
+    ]);
+}

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRemoveCompanionDeviceIq = buildRemoveCompanionDeviceIq;
+const defaults_1 = require("../../../protocol/defaults");
+const nodes_1 = require("../../../protocol/nodes");
+const query_1 = require("../../node/query");
+function buildRemoveCompanionDeviceIq(deviceJid, reason) {
+    return (0, query_1.buildIqNode)('set', defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.MD, [
+        {
+            tag: 'remove-companion-device',
+            attrs: { jid: deviceJid, reason }
+        }
+    ]);
+}

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

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildGetEmailIq = buildGetEmailIq;
+exports.buildSetEmailIq = buildSetEmailIq;
+exports.buildRequestEmailVerificationCodeIq = buildRequestEmailVerificationCodeIq;
+exports.buildVerifyEmailCodeIq = buildVerifyEmailCodeIq;
+exports.buildConfirmEmailIq = buildConfirmEmailIq;
+const defaults_1 = require("../../../protocol/defaults");
+const email_1 = require("../../../protocol/email");
+const query_1 = require("../../node/query");
+function buildGetEmailIq() {
+    return (0, query_1.buildIqNode)('get', defaults_1.WA_DEFAULTS.HOST_DOMAIN, email_1.WA_EMAIL_XMLNS, [
+        { tag: email_1.WA_EMAIL_TAGS.EMAIL, attrs: {} }
+    ]);
+}
+function buildSetEmailIq(email, context) {
+    if (email.length === 0 || email.length > email_1.WA_EMAIL_LIMITS.EMAIL_MAX_LENGTH) {
+        throw new Error(`email length must be between 1 and ${email_1.WA_EMAIL_LIMITS.EMAIL_MAX_LENGTH} chars`);
+    }
+    const emailChildren = [];
+    if (context !== undefined) {
+        emailChildren.push({ tag: email_1.WA_EMAIL_TAGS.CONTEXT, attrs: {}, content: context });
+    }
+    emailChildren.push({ tag: email_1.WA_EMAIL_TAGS.EMAIL_ADDRESS, attrs: {}, content: email });
+    return (0, query_1.buildIqNode)('set', defaults_1.WA_DEFAULTS.HOST_DOMAIN, email_1.WA_EMAIL_XMLNS, [
+        { tag: email_1.WA_EMAIL_TAGS.EMAIL, attrs: {}, content: emailChildren }
+    ]);
+}
+function buildRequestEmailVerificationCodeIq(input) {
+    assertLocaleField('languageCode', input.languageCode);
+    assertLocaleField('localeCode', input.localeCode);
+    return (0, query_1.buildIqNode)('set', defaults_1.WA_DEFAULTS.HOST_DOMAIN, email_1.WA_EMAIL_XMLNS, [
+        {
+            tag: email_1.WA_EMAIL_TAGS.VERIFY_EMAIL,
+            attrs: {},
+            content: [
+                { tag: email_1.WA_EMAIL_TAGS.LG, attrs: {}, content: input.languageCode },
+                { tag: email_1.WA_EMAIL_TAGS.LC, attrs: {}, content: input.localeCode }
+            ]
+        }
+    ]);
+}
+function buildVerifyEmailCodeIq(code) {
+    if (code.length !== email_1.WA_EMAIL_LIMITS.CODE_LENGTH) {
+        throw new Error(`verification code must be exactly ${email_1.WA_EMAIL_LIMITS.CODE_LENGTH} chars`);
+    }
+    return (0, query_1.buildIqNode)('set', defaults_1.WA_DEFAULTS.HOST_DOMAIN, email_1.WA_EMAIL_XMLNS, [
+        {
+            tag: email_1.WA_EMAIL_TAGS.VERIFY_EMAIL,
+            attrs: {},
+            content: [{ tag: email_1.WA_EMAIL_TAGS.CODE, attrs: {}, content: code }]
+        }
+    ]);
+}
+function buildConfirmEmailIq(context) {
+    const children = context !== undefined
+        ? [{ tag: email_1.WA_EMAIL_TAGS.CONTEXT, attrs: {}, content: context }]
+        : undefined;
+    return (0, query_1.buildIqNode)('set', defaults_1.WA_DEFAULTS.HOST_DOMAIN, email_1.WA_EMAIL_XMLNS, [
+        {
+            tag: email_1.WA_EMAIL_TAGS.CONFIRM_EMAIL,
+            attrs: {},
+            ...(children !== undefined ? { content: children } : {})
+        }
+    ]);
+}
+function assertLocaleField(field, value) {
+    if (value.length < email_1.WA_EMAIL_LIMITS.LOCALE_MIN_LENGTH ||
+        value.length > email_1.WA_EMAIL_LIMITS.LOCALE_MAX_LENGTH) {
+        throw new Error(`${field} must be between ${email_1.WA_EMAIL_LIMITS.LOCALE_MIN_LENGTH} and ${email_1.WA_EMAIL_LIMITS.LOCALE_MAX_LENGTH} chars`);
+    }
+}

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildOfflineBatchNode = buildOfflineBatchNode;
+const constants_1 = require("../../../protocol/constants");
+function buildOfflineBatchNode(count) {
+    return {
+        tag: constants_1.WA_NODE_TAGS.INFO_BULLETIN,
+        attrs: {},
+        content: [
+            {
+                tag: 'offline_batch',
+                attrs: { count: String(count) },
+                content: undefined
+            }
+        ]
+    };
+}

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildPreKeyUploadIq = buildPreKeyUploadIq;
 exports.buildSignedPreKeyRotateIq = buildSignedPreKeyRotateIq;
 exports.buildMissingPreKeysFetchIq = buildMissingPreKeysFetchIq;
+const keys_1 = require("../../../crypto/core/keys");
 const constants_1 = require("../../../protocol/constants");
 const constants_2 = require("../../../signal/api/constants");
 const query_1 = require("../../node/query");
@@ -20,55 +21,51 @@ function buildSignedPreKeyNode(signedPreKey) {
             {
                 tag: constants_1.WA_NODE_TAGS.VALUE,
                 attrs: {},
-                content: (0, bytes_1.toBytesView)(signedPreKey.keyPair.pubKey)
+                content: (0, keys_1.toRawPubKey)(signedPreKey.keyPair.pubKey)
             },
             {
                 tag: constants_1.WA_NODE_TAGS.SIGNATURE,
                 attrs: {},
-                content: (0, bytes_1.toBytesView)(signedPreKey.signature)
+                content: signedPreKey.signature
             }
         ]
     };
 }
 function buildPreKeyUploadIq(registrationInfo, signedPreKey, preKeys) {
-    return (0, query_1.buildIqNode)('set', constants_1.WA_DEFAULTS.HOST_DOMAIN, constants_1.WA_XMLNS.SIGNAL, [
-        {
-            tag: constants_1.WA_NODE_TAGS.REGISTRATION,
-            attrs: {},
-            content: (0, bytes_1.intToBytes)(4, registrationInfo.registrationId)
-        },
-        {
-            tag: constants_1.WA_NODE_TAGS.TYPE,
-            attrs: {},
-            content: constants_2.SIGNAL_KEY_BUNDLE_TYPE_BYTES
-        },
-        {
-            tag: constants_1.WA_NODE_TAGS.IDENTITY,
-            attrs: {},
-            content: (0, bytes_1.toBytesView)(registrationInfo.identityKeyPair.pubKey)
-        },
-        {
-            tag: constants_1.WA_NODE_TAGS.LIST,
+    const children = [];
+    children.push({
+        tag: constants_1.WA_NODE_TAGS.IDENTITY,
+        attrs: {},
+        content: (0, keys_1.toRawPubKey)(registrationInfo.identityKeyPair.pubKey)
+    }, {
+        tag: constants_1.WA_NODE_TAGS.REGISTRATION,
+        attrs: {},
+        content: (0, bytes_1.intToBytes)(4, registrationInfo.registrationId)
+    }, {
+        tag: constants_1.WA_NODE_TAGS.TYPE,
+        attrs: {},
+        content: constants_2.SIGNAL_KEY_BUNDLE_TYPE_BYTES
+    }, {
+        tag: constants_1.WA_NODE_TAGS.LIST,
+        attrs: {},
+        content: preKeys.map((record) => ({
+            tag: constants_1.WA_NODE_TAGS.KEY,
             attrs: {},
-            content: preKeys.map((record) => ({
-                tag: constants_1.WA_NODE_TAGS.KEY,
-                attrs: {},
-                content: [
-                    {
-                        tag: constants_1.WA_NODE_TAGS.ID,
-                        attrs: {},
-                        content: (0, bytes_1.intToBytes)(3, record.keyId)
-                    },
-                    {
-                        tag: constants_1.WA_NODE_TAGS.VALUE,
-                        attrs: {},
-                        content: (0, bytes_1.toBytesView)(record.keyPair.pubKey)
-                    }
-                ]
-            }))
-        },
-        buildSignedPreKeyNode(signedPreKey)
-    ]);
+            content: [
+                {
+                    tag: constants_1.WA_NODE_TAGS.ID,
+                    attrs: {},
+                    content: (0, bytes_1.intToBytes)(3, record.keyId)
+                },
+                {
+                    tag: constants_1.WA_NODE_TAGS.VALUE,
+                    attrs: {},
+                    content: (0, keys_1.toRawPubKey)(record.keyPair.pubKey)
+                }
+            ]
+        }))
+    }, buildSignedPreKeyNode(signedPreKey));
+    return (0, query_1.buildIqNode)('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, [

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPresenceNode = buildPresenceNode;
+function buildPresenceNode(input) {
+    const attrs = {};
+    if (input?.type) {
+        attrs.type = input.type;
+    }
+    if (input?.name) {
+        attrs.name = input.name;
+    }
+    return {
+        tag: 'presence',
+        attrs
+    };
+}

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

@@ -3,32 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildPrivacyTokenIqNode = buildPrivacyTokenIqNode;
 exports.buildTcTokenMessageNode = buildTcTokenMessageNode;
 exports.buildCsTokenMessageNode = buildCsTokenMessageNode;
+const defaults_1 = require("../../../protocol/defaults");
+const jid_1 = require("../../../protocol/jid");
 const nodes_1 = require("../../../protocol/nodes");
 const privacy_token_1 = require("../../../protocol/privacy-token");
+const query_1 = require("../../node/query");
 function buildPrivacyTokenIqNode(input) {
-    return {
-        tag: nodes_1.WA_NODE_TAGS.IQ,
-        attrs: {
-            type: nodes_1.WA_IQ_TYPES.SET,
-            xmlns: nodes_1.WA_XMLNS.PRIVACY
-        },
-        content: [
-            {
-                tag: privacy_token_1.WA_PRIVACY_TOKEN_TAGS.TOKENS,
-                attrs: {},
-                content: [
-                    {
-                        tag: privacy_token_1.WA_PRIVACY_TOKEN_TAGS.TOKEN,
-                        attrs: {
-                            jid: input.jid,
-                            t: String(input.timestampS),
-                            type: input.type ?? privacy_token_1.WA_PRIVACY_TOKEN_TYPES.TRUSTED_CONTACT
-                        }
+    return (0, query_1.buildIqNode)('set', defaults_1.WA_DEFAULTS.HOST_DOMAIN, nodes_1.WA_XMLNS.PRIVACY, [
+        {
+            tag: privacy_token_1.WA_PRIVACY_TOKEN_TAGS.TOKENS,
+            attrs: {},
+            content: [
+                {
+                    tag: privacy_token_1.WA_PRIVACY_TOKEN_TAGS.TOKEN,
+                    attrs: {
+                        jid: (0, jid_1.toUserJid)(input.jid),
+                        t: String(input.timestampS),
+                        type: input.type ?? privacy_token_1.WA_PRIVACY_TOKEN_TYPES.TRUSTED_CONTACT
                     }
-                ]
-            }
-        ]
-    };
+                }
+            ]
+        }
+    ]);
 }
 function buildTcTokenMessageNode(token) {
     return {

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

@@ -78,7 +78,7 @@ function buildRetryReceiptNode(input) {
         id: input.originalMsgId,
         t: input.t
     };
-    if (input.error !== undefined) {
+    if (input.error !== undefined && input.error !== 0) {
         retryAttrs.error = String(input.error);
     }
     const content = [

package/dist/transport/node/helpers.js

@@ -11,9 +11,11 @@ exports.getNodeChildrenNonEmptyUtf8ByTag = getNodeChildrenNonEmptyUtf8ByTag;
 exports.findNodeChildrenByTags = findNodeChildrenByTags;
 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");
 const bytes_1 = require("../../util/bytes");
 const EMPTY_NODE_CHILDREN = Object.freeze([]);
@@ -142,6 +144,14 @@ function decodeNodeContentUtf8OrBytes(value, field) {
     }
     throw new Error(`node ${field} has no binary content`);
 }
+function getNodeTextContent(node) {
+    const content = node.content;
+    if (content instanceof Uint8Array)
+        return bytes_1.TEXT_DECODER.decode(content);
+    if (typeof content === 'string')
+        return content;
+    return undefined;
+}
 function decodeNodeContentBase64OrBytes(value, field) {
     if (value === null || value === undefined) {
         throw new Error(`missing binary node content for ${field}`);
@@ -171,3 +181,19 @@ async function createNodeIdGenerator() {
         }
     };
 }
+function createMobileNodeIdGenerator() {
+    let featureCounter = 0;
+    let systemCounter = 0;
+    return {
+        prefix: '0',
+        next() {
+            const id = `0${featureCounter.toString(16)}`;
+            featureCounter = (featureCounter + 1) & 0xffff;
+            return id;
+        },
+        nextSystem() {
+            systemCounter = (systemCounter + 1) & 0xffff;
+            return systemCounter.toString(16);
+        }
+    };
+}