zapo-js 0.1.2 → 0.3.0

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

@@ -0,0 +1,114 @@
+import { connect as netConnect } from 'node:net';
+import { WA_READY_STATES } from '../../protocol/constants.js';
+import { TEXT_ENCODER } from '../../util/bytes.js';
+export class WaMobileTcpSocket {
+    constructor(url, _protocols, _options) {
+        this.binaryType = 'arraybuffer';
+        this.readyState = WA_READY_STATES.CONNECTING;
+        this.onopen = null;
+        this.onclose = null;
+        this.onerror = null;
+        this.onmessage = null;
+        this.closedCode = 1000;
+        this.closedReason = '';
+        this.closedClean = true;
+        this.forceCloseTimer = null;
+        const { host, port } = parseTcpUrl(url);
+        this.socket = netConnect({ host, port });
+        this.socket.on('connect', () => {
+            if (this.readyState !== WA_READY_STATES.CONNECTING)
+                return;
+            this.readyState = WA_READY_STATES.OPEN;
+            this.onopen?.({});
+        });
+        this.socket.on('data', (chunk) => {
+            if (!this.onmessage || this.readyState !== WA_READY_STATES.OPEN)
+                return;
+            const copy = new Uint8Array(chunk.byteLength);
+            copy.set(chunk);
+            this.onmessage({ data: copy });
+        });
+        this.socket.on('error', (err) => {
+            this.closedClean = false;
+            this.closedReason = err.message;
+            this.onerror?.({ reason: err.message });
+        });
+        this.socket.on('close', (hadError) => {
+            this.readyState = WA_READY_STATES.CLOSED;
+            if (this.forceCloseTimer) {
+                clearTimeout(this.forceCloseTimer);
+                this.forceCloseTimer = null;
+            }
+            if (hadError)
+                this.closedClean = false;
+            this.onclose?.({
+                code: this.closedCode,
+                reason: this.closedReason,
+                wasClean: this.closedClean
+            });
+        });
+    }
+    send(data) {
+        if (this.readyState !== WA_READY_STATES.OPEN) {
+            throw new Error('WaMobileTcpSocket: send() called on non-OPEN socket');
+        }
+        let bytes;
+        if (typeof data === 'string') {
+            bytes = TEXT_ENCODER.encode(data);
+        }
+        else if (data instanceof Uint8Array) {
+            bytes = data;
+        }
+        else {
+            bytes = new Uint8Array(data);
+        }
+        this.socket.write(bytes);
+    }
+    close(code, reason) {
+        if (this.readyState === WA_READY_STATES.CLOSED)
+            return;
+        this.readyState = WA_READY_STATES.CLOSING;
+        this.closedCode = code ?? 1000;
+        this.closedReason = reason ?? '';
+        this.socket.end();
+        this.forceCloseTimer = setTimeout(() => {
+            this.forceCloseTimer = null;
+            if (this.readyState !== WA_READY_STATES.CLOSED) {
+                this.socket.destroy();
+            }
+        }, 5000);
+        this.forceCloseTimer.unref();
+    }
+}
+function parseTcpUrl(url) {
+    let work = url;
+    if (work.startsWith('tcp://')) {
+        work = work.slice('tcp://'.length);
+    }
+    const queryIdx = work.indexOf('?');
+    if (queryIdx >= 0) {
+        work = work.slice(0, queryIdx);
+    }
+    const slash = work.indexOf('/');
+    if (slash >= 0) {
+        work = work.slice(0, slash);
+    }
+    const colon = work.lastIndexOf(':');
+    const host = colon === -1 ? work : work.slice(0, colon);
+    if (host.length === 0) {
+        throw new Error(`WaMobileTcpSocket: invalid host in ${JSON.stringify(url)}`);
+    }
+    if (colon === -1) {
+        return { host, port: 443 };
+    }
+    const portText = work.slice(colon + 1);
+    if (!/^\d+$/.test(portText)) {
+        throw new Error(`WaMobileTcpSocket: invalid port in ${JSON.stringify(url)}`);
+    }
+    const port = Number(portText);
+    if (port < 1 || port > 65535) {
+        throw new Error(`WaMobileTcpSocket: port out of range in ${JSON.stringify(url)}`);
+    }
+    return { host, port };
+}
+export const WaMobileTcpSocketCtor = WaMobileTcpSocket;

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

@@ -1,14 +1,15 @@
 import { WA_DEFAULTS, WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from '../../protocol/constants.js';
 import { toError } from '../../util/primitives.js';
-import { formatNodeIdPrefixFromSeed } from './helpers.js';
+import { createMobileNodeIdGenerator, createNodeIdGenerator } from './helpers.js';
 export class WaNodeOrchestrator {
     constructor(options) {
         this.logger = options.logger;
         this.sendNodeFn = options.sendNode;
         this.defaultTimeoutMs = options.defaultTimeoutMs ?? WA_DEFAULTS.NODE_QUERY_TIMEOUT_MS;
         this.hostDomain = options.hostDomain ?? WA_DEFAULTS.HOST_DOMAIN;
-        this.stanzaPrefix = null;
-        this.stanzaCounter = 0;
+        this.mobileIqIdFormat = options.mobileIqIdFormat === true;
+        this.idGenerator = null;
+        this.idGeneratorReady = null;
         this.pendingQueries = new Map();
     }
     hasPending() {
@@ -69,12 +70,12 @@ export class WaNodeOrchestrator {
         this.logger.debug('auto-responded to ping iq', { id: node.attrs.id, xmlns });
         return true;
     }
-    async sendNode(node) {
-        const outbound = 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 = 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');
@@ -110,14 +111,13 @@ export class WaNodeOrchestrator {
             });
         });
     }
-    withAutoId(node) {
+    async withAutoId(node, useSystemId = false) {
         if (node.attrs.id) {
             return node;
         }
-        const prefix = this.getStanzaPrefix();
-        this.stanzaCounter += 1;
-        const generatedId = `${prefix}${this.stanzaCounter}`;
-        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: {
@@ -126,16 +126,31 @@ export class WaNodeOrchestrator {
             }
         };
     }
-    getStanzaPrefix() {
-        if (this.stanzaPrefix) {
-            return this.stanzaPrefix;
+    async getIdGenerator() {
+        if (this.idGenerator) {
+            return this.idGenerator;
+        }
+        if (this.mobileIqIdFormat) {
+            this.idGenerator = createMobileNodeIdGenerator();
+            this.logger.debug('generated stanza prefix (mobile)', {
+                prefix: this.idGenerator.prefix
+            });
+            return this.idGenerator;
+        }
+        if (!this.idGeneratorReady) {
+            this.idGeneratorReady = createNodeIdGenerator();
+        }
+        try {
+            const generator = await this.idGeneratorReady;
+            if (!this.idGenerator) {
+                this.idGenerator = generator;
+                this.logger.debug('generated stanza prefix', { prefix: generator.prefix });
+            }
+            return generator;
+        }
+        catch (error) {
+            this.idGeneratorReady = null;
+            throw toError(error);
         }
-        this.stanzaPrefix = this.generateStanzaPrefix();
-        return this.stanzaPrefix;
-    }
-    generateStanzaPrefix() {
-        const prefix = formatNodeIdPrefixFromSeed(crypto.getRandomValues(new Uint8Array(4)));
-        this.logger.debug('generated stanza prefix', { prefix });
-        return prefix;
     }
 }

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

@@ -0,0 +1,20 @@
+import { WA_ABPROPS_PROTOCOL_VERSION } from '../../../protocol/abprops.js';
+import { WA_DEFAULTS, WA_XMLNS } from '../../../protocol/constants.js';
+import { buildIqNode } from '../../node/query.js';
+export function buildGetAbPropsIq(options) {
+    const propsAttrs = {
+        protocol: WA_ABPROPS_PROTOCOL_VERSION
+    };
+    if (options?.hash) {
+        propsAttrs.hash = options.hash;
+    }
+    if (options?.refreshId !== undefined && options.refreshId !== null) {
+        propsAttrs.refresh_id = `${options.refreshId}`;
+    }
+    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.ABPROPS, [
+        {
+            tag: 'props',
+            attrs: propsAttrs
+        }
+    ]);
+}

package/dist/esm/transport/node/builders/business.js

@@ -0,0 +1,129 @@
+import { WA_DEFAULTS, WA_XMLNS } from '../../../protocol/constants.js';
+import { buildIqNode } from '../../node/query.js';
+export const WA_BUSINESS_PROFILE_VERSION = 116;
+export function buildGetBusinessProfileIq(jids, version = WA_BUSINESS_PROFILE_VERSION) {
+    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
+        {
+            tag: 'business_profile',
+            attrs: { v: `${version}` },
+            content: jids.map((jid) => ({
+                tag: 'profile',
+                attrs: { jid }
+            }))
+        }
+    ]);
+}
+export function buildEditBusinessProfileIq(input) {
+    const children = [];
+    if (input.address !== undefined) {
+        children.push({ tag: 'address', attrs: {}, content: input.address });
+    }
+    if (input.description !== undefined) {
+        children.push({ tag: 'description', attrs: {}, content: input.description });
+    }
+    if (input.email !== undefined) {
+        children.push({ tag: 'email', attrs: {}, content: input.email });
+    }
+    if (input.latitude !== undefined) {
+        children.push({ tag: 'latitude', attrs: {}, content: `${input.latitude}` });
+    }
+    if (input.longitude !== undefined) {
+        children.push({ tag: 'longitude', attrs: {}, content: `${input.longitude}` });
+    }
+    if (input.websites !== undefined) {
+        if (input.websites.length > 2) {
+            throw new Error('business profile supports at most 2 websites');
+        }
+        if (input.websites.length === 0) {
+            children.push({ tag: 'website', attrs: {} });
+        }
+        else {
+            children.push({ tag: 'website', attrs: {}, content: input.websites[0].url });
+            if (input.websites.length > 1) {
+                children.push({ tag: 'website', attrs: {}, content: input.websites[1].url });
+            }
+        }
+    }
+    if (input.categories !== undefined) {
+        children.push({
+            tag: 'categories',
+            attrs: {},
+            content: input.categories.map((cat) => ({
+                tag: 'category',
+                attrs: { id: cat.id }
+            }))
+        });
+    }
+    if (input.businessHours !== undefined) {
+        children.push(buildBusinessHoursNode(input.businessHours));
+    }
+    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
+        {
+            tag: 'business_profile',
+            attrs: { v: '3', mutation_type: 'delta' },
+            content: children
+        }
+    ]);
+}
+function buildBusinessHoursNode(hours) {
+    const configNodes = new Array(hours.config.length);
+    for (let i = 0; i < hours.config.length; i += 1) {
+        const entry = hours.config[i];
+        const attrs = {
+            day_of_week: entry.dayOfWeek,
+            mode: entry.mode
+        };
+        if (entry.openTime !== undefined) {
+            attrs.open_time = `${entry.openTime}`;
+        }
+        if (entry.closeTime !== undefined) {
+            attrs.close_time = `${entry.closeTime}`;
+        }
+        configNodes[i] = { tag: 'business_hours_config', attrs };
+    }
+    const hoursAttrs = {};
+    if (hours.timezone) {
+        hoursAttrs.timezone = hours.timezone;
+    }
+    return {
+        tag: 'business_hours',
+        attrs: hoursAttrs,
+        content: configNodes
+    };
+}
+export function buildGetVerifiedNameIq(jid) {
+    return buildIqNode('get', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
+        {
+            tag: 'verified_name',
+            attrs: { jid }
+        }
+    ]);
+}
+export function buildUpdateCoverPhotoIq(id, timestamp, token) {
+    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
+        {
+            tag: 'business_profile',
+            attrs: { v: '3', mutation_type: 'delta' },
+            content: [
+                {
+                    tag: 'cover_photo',
+                    attrs: { op: 'update', id, ts: timestamp, token }
+                }
+            ]
+        }
+    ]);
+}
+export function buildDeleteCoverPhotoIq(id) {
+    return buildIqNode('set', WA_DEFAULTS.HOST_DOMAIN, WA_XMLNS.BUSINESS, [
+        {
+            tag: 'business_profile',
+            attrs: { v: '3', mutation_type: 'delta' },
+            content: [
+                {
+                    tag: 'cover_photo',
+                    attrs: { op: 'delete', id }
+                }
+            ]
+        }
+    ]);
+}

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

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

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

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