@zervonex/baileys 0.0.0-stage → 3.0.1

package/lib/WAM/encode.js

@@ -0,0 +1,150 @@
+import { BinaryInfo } from './BinaryInfo.js';
+import { FLAG_BYTE, FLAG_EVENT, FLAG_EXTENDED, FLAG_FIELD, FLAG_GLOBAL, WEB_EVENTS, WEB_GLOBALS } from './constants.js';
+const getHeaderBitLength = (key) => (key < 256 ? 2 : 3);
+export const encodeWAM = (binaryInfo) => {
+    binaryInfo.buffer = [];
+    encodeWAMHeader(binaryInfo);
+    encodeEvents(binaryInfo);
+    const totalSize = binaryInfo.buffer.map(a => a.length).reduce((a, b) => a + b);
+    const buffer = Buffer.alloc(totalSize);
+    let offset = 0;
+    for (const buffer_ of binaryInfo.buffer) {
+        buffer_.copy(buffer, offset);
+        offset += buffer_.length;
+    }
+    return buffer;
+};
+function encodeWAMHeader(binaryInfo) {
+    const headerBuffer = Buffer.alloc(8); // starting buffer
+    headerBuffer.write('WAM', 0, 'utf8');
+    headerBuffer.writeUInt8(binaryInfo.protocolVersion, 3);
+    headerBuffer.writeUInt8(1, 4); //random flag
+    headerBuffer.writeUInt16BE(binaryInfo.sequence, 5);
+    headerBuffer.writeUInt8(0, 7); // regular channel
+    binaryInfo.buffer.push(headerBuffer);
+}
+function encodeGlobalAttributes(binaryInfo, globals) {
+    for (const [key, _value] of Object.entries(globals)) {
+        const id = WEB_GLOBALS.find(a => a?.name === key).id;
+        let value = _value;
+        if (typeof value === 'boolean') {
+            value = value ? 1 : 0;
+        }
+        binaryInfo.buffer.push(serializeData(id, value, FLAG_GLOBAL));
+    }
+}
+function encodeEvents(binaryInfo) {
+    for (const [name, { props, globals }] of binaryInfo.events.map(a => Object.entries(a)[0])) {
+        encodeGlobalAttributes(binaryInfo, globals);
+        const event = WEB_EVENTS.find(a => a.name === name);
+        const props_ = Object.entries(props);
+        let extended = false;
+        for (const [, value] of props_) {
+            extended || (extended = value !== null);
+        }
+        const eventFlag = extended ? FLAG_EVENT : FLAG_EVENT | FLAG_EXTENDED;
+        binaryInfo.buffer.push(serializeData(event.id, -event.weight, eventFlag));
+        for (let i = 0; i < props_.length; i++) {
+            const [key, _value] = props_[i];
+            const id = event.props[key]?.[0];
+            extended = i < props_.length - 1;
+            let value = _value;
+            if (typeof value === 'boolean') {
+                value = value ? 1 : 0;
+            }
+            const fieldFlag = extended ? FLAG_EVENT : FLAG_FIELD | FLAG_EXTENDED;
+            binaryInfo.buffer.push(serializeData(id, value, fieldFlag));
+        }
+    }
+}
+function serializeData(key, value, flag) {
+    const bufferLength = getHeaderBitLength(key);
+    let buffer;
+    let offset = 0;
+    if (value === null) {
+        if (flag === FLAG_GLOBAL) {
+            buffer = Buffer.alloc(bufferLength);
+            offset = serializeHeader(buffer, offset, key, flag);
+            return buffer;
+        }
+    }
+    else if (typeof value === 'number' && Number.isInteger(value)) {
+        // is number
+        if (value === 0 || value === 1) {
+            buffer = Buffer.alloc(bufferLength);
+            offset = serializeHeader(buffer, offset, key, flag | ((value + 1) << 4));
+            return buffer;
+        }
+        else if (-128 <= value && value < 128) {
+            buffer = Buffer.alloc(bufferLength + 1);
+            offset = serializeHeader(buffer, offset, key, flag | (3 << 4));
+            buffer.writeInt8(value, offset);
+            return buffer;
+        }
+        else if (-32768 <= value && value < 32768) {
+            buffer = Buffer.alloc(bufferLength + 2);
+            offset = serializeHeader(buffer, offset, key, flag | (4 << 4));
+            buffer.writeInt16LE(value, offset);
+            return buffer;
+        }
+        else if (-2147483648 <= value && value < 2147483648) {
+            buffer = Buffer.alloc(bufferLength + 4);
+            offset = serializeHeader(buffer, offset, key, flag | (5 << 4));
+            buffer.writeInt32LE(value, offset);
+            return buffer;
+        }
+        else {
+            buffer = Buffer.alloc(bufferLength + 8);
+            offset = serializeHeader(buffer, offset, key, flag | (7 << 4));
+            buffer.writeDoubleLE(value, offset);
+            return buffer;
+        }
+    }
+    else if (typeof value === 'number') {
+        // is float
+        buffer = Buffer.alloc(bufferLength + 8);
+        offset = serializeHeader(buffer, offset, key, flag | (7 << 4));
+        buffer.writeDoubleLE(value, offset);
+        return buffer;
+    }
+    else if (typeof value === 'string') {
+        // is string
+        const utf8Bytes = Buffer.byteLength(value, 'utf8');
+        if (utf8Bytes < 256) {
+            buffer = Buffer.alloc(bufferLength + 1 + utf8Bytes);
+            offset = serializeHeader(buffer, offset, key, flag | (8 << 4));
+            buffer.writeUint8(utf8Bytes, offset++);
+        }
+        else if (utf8Bytes < 65536) {
+            buffer = Buffer.alloc(bufferLength + 2 + utf8Bytes);
+            offset = serializeHeader(buffer, offset, key, flag | (9 << 4));
+            buffer.writeUInt16LE(utf8Bytes, offset);
+            offset += 2;
+        }
+        else {
+            buffer = Buffer.alloc(bufferLength + 4 + utf8Bytes);
+            offset = serializeHeader(buffer, offset, key, flag | (10 << 4));
+            buffer.writeUInt32LE(utf8Bytes, offset);
+            offset += 4;
+        }
+        buffer.write(value, offset, 'utf8');
+        return buffer;
+    }
+    throw 'missing';
+}
+function serializeHeader(buffer, offset, key, flag) {
+    if (key < 256) {
+        buffer.writeUInt8(flag, offset);
+        offset += 1;
+        buffer.writeUInt8(key, offset);
+        offset += 1;
+    }
+    else {
+        buffer.writeUInt8(flag | FLAG_BYTE, offset);
+        offset += 1;
+        buffer.writeUInt16LE(key, offset);
+        offset += 2;
+    }
+    return offset;
+}
+//# sourceMappingURL=encode.js.map

package/lib/WAM/index.js

@@ -0,0 +1,3 @@
+export * from './BinaryInfo.js'
+export * from './encode.js'
+export * from './constants.js'

package/lib/WAUSync/Protocols/USyncBotProfileProtocol.js

@@ -0,0 +1,30 @@
+import { getBinaryNodeChild, getBinaryNodeChildren, getBinaryNodeChildString } from '../../WABinary/index.js';
+
+export class USyncBotProfileProtocol {
+    constructor() { this.name = 'bot'; }
+
+    getQueryElement() { return { tag: 'bot', attrs: {}, content: [{ tag: 'profile', attrs: { v: '1' } }] }; }
+
+    getUserElement(user) { return { tag: 'bot', attrs: {}, content: [{ tag: 'profile', attrs: { persona_id: user.personaId } }] }; }
+
+    parser(node) {
+        const botNode      = getBinaryNodeChild(node, 'bot');
+        const profile      = getBinaryNodeChild(botNode, 'profile');
+        const commandsNode = getBinaryNodeChild(profile, 'commands');
+        const promptsNode  = getBinaryNodeChild(profile, 'prompts');
+        const commands = getBinaryNodeChildren(commandsNode, 'command').map(c => ({ name: getBinaryNodeChildString(c, 'name'), description: getBinaryNodeChildString(c, 'description') }));
+        const prompts  = getBinaryNodeChildren(promptsNode, 'prompt').map(p => `${getBinaryNodeChildString(p, 'emoji')} ${getBinaryNodeChildString(p, 'text')}`);
+        return {
+            isDefault: !!getBinaryNodeChild(profile, 'default'),
+            jid: node.attrs.jid,
+            name: getBinaryNodeChildString(profile, 'name'),
+            attributes: getBinaryNodeChildString(profile, 'attributes'),
+            description: getBinaryNodeChildString(profile, 'description'),
+            category: getBinaryNodeChildString(profile, 'category'),
+            personaId: profile.attrs['persona_id'],
+            commandsDescription: getBinaryNodeChildString(commandsNode, 'description'),
+            commands,
+            prompts
+        };
+    }
+}

package/lib/WAUSync/Protocols/USyncBusinessProtocol.js

@@ -0,0 +1,48 @@
+import { assertNodeErrorFree, getBinaryNodeChild, getBinaryNodeChildren } from '../../WABinary/index.js';
+
+export class USyncBusinessProtocol {
+    constructor(profileVersion = '2') { this.name = 'business'; this.profileVersion = profileVersion; }
+
+    getQueryElement() { return { tag: 'business', attrs: {}, content: [{ tag: 'verified_name', attrs: {} }, { tag: 'profile', attrs: { v: this.profileVersion } }] }; }
+
+    getUserElement(user) {
+        const children = [];
+        if (user.verifiedNameSerial) children.push({ tag: 'verified_name', attrs: { serial: user.verifiedNameSerial } });
+        if (user.businessProfileTag) children.push({ tag: 'profile', attrs: { tag: user.businessProfileTag } });
+        return children.length > 0 ? { tag: 'business', attrs: {}, content: children } : null;
+    }
+
+    parser(node) {
+        if (node.tag !== 'business') return null;
+        assertNodeErrorFree(node);
+        const verifiedNameNode = getBinaryNodeChild(node, 'verified_name');
+        const profileNode      = getBinaryNodeChild(node, 'profile');
+
+        let businessHours;
+        if (profileNode) {
+            const bhNode = getBinaryNodeChild(profileNode, 'business_hours');
+            if (bhNode) businessHours = { timezone: bhNode.attrs?.timezone ?? null, config: getBinaryNodeChildren(bhNode, 'business_hours_config').map(({ attrs }) => ({ dayOfWeek: attrs?.day_of_week ?? null, openTime: attrs?.open_time ?? null, closeTime: attrs?.close_time ?? null, mode: attrs?.mode ?? null })) };
+        }
+
+        const addressNode   = profileNode ? getBinaryNodeChild(profileNode, 'address') : null;
+        const businessAddress = addressNode?.content ? (Buffer.isBuffer(addressNode.content) ? addressNode.content.toString() : String(addressNode.content)) : (profileNode?.attrs?.address ?? null);
+        const catalogStatus = profileNode ? { exists: profileNode.attrs?.catalog_exists === 'true' || profileNode.attrs?.catalog_exists === true, sendAll: profileNode.attrs?.catalog_send_all === 'true' || profileNode.attrs?.catalog_send_all === true } : null;
+        const cartEnabled    = profileNode?.attrs?.cart_enabled     !== undefined ? profileNode.attrs.cart_enabled     === 'true' || profileNode.attrs.cart_enabled     === true : null;
+        const webCartEnabled = profileNode?.attrs?.web_cart_enabled !== undefined ? profileNode.attrs.web_cart_enabled === 'true' || profileNode.attrs.web_cart_enabled === true : null;
+
+        return {
+            verifiedName: verifiedNameNode?.content ?? null,
+            verifiedLevel: verifiedNameNode?.attrs?.verified_level ?? null,
+            verifiedNameLevel: verifiedNameNode?.attrs?.verified_level ?? null,
+            profileTag: profileNode?.attrs?.tag ?? null,
+            pnJid: node.attrs?.pn_jid ?? null,
+            businessHours: businessHours ?? null,
+            businessAddress,
+            catalogStatus,
+            cartEnabled,
+            webCartEnabled,
+            webCartOnOff: profileNode?.attrs?.web_cart_on_off ?? null,
+            commerceExperience: profileNode?.attrs?.commerce_experience ?? null
+        };
+    }
+}

package/lib/WAUSync/Protocols/USyncContactProtocol.js

@@ -0,0 +1,23 @@
+import { assertNodeErrorFree } from '../../WABinary/index.js';
+
+export class USyncContactProtocol {
+    constructor() { this.name = 'contact'; }
+
+    getQueryElement() { return { tag: 'contact', attrs: {} }; }
+
+    getUserElement(user) {
+        if (user.phone)    return { tag: 'contact', attrs: {}, content: user.phone };
+        if (user.username) return { tag: 'contact', attrs: { username: user.username, ...(user.usernameKey ? { pin: user.usernameKey } : {}), ...(user.lid ? { lid: user.lid } : {}) } };
+        if (user.type)     return { tag: 'contact', attrs: { type: user.type } };
+        return { tag: 'contact', attrs: {} };
+    }
+
+    parser(node) {
+        if (node.tag !== 'contact') return false;
+        assertNodeErrorFree(node);
+        const inWA = node?.attrs?.type === 'in';
+        const restrictionType = node?.attrs?.stella_addressbook_restriction_type;
+        if (restrictionType !== undefined) return { inWA, stellaAddressbookRestrictionType: restrictionType };
+        return inWA;
+    }
+}

package/lib/WAUSync/Protocols/USyncDeviceProtocol.js

@@ -0,0 +1,28 @@
+import { assertNodeErrorFree, getBinaryNodeChild } from '../../WABinary/index.js';
+
+export class USyncDeviceProtocol {
+    constructor() { this.name = 'devices'; }
+
+    getQueryElement() { return { tag: 'devices', attrs: { version: '2' } }; }
+
+    getUserElement() { return null; }
+
+    parser(node) {
+        const deviceList = [];
+        let keyIndex;
+        if (node.tag === 'devices') {
+            assertNodeErrorFree(node);
+            const deviceListNode = getBinaryNodeChild(node, 'device-list');
+            const keyIndexNode   = getBinaryNodeChild(node, 'key-index-list');
+            if (Array.isArray(deviceListNode?.content)) {
+                for (const { tag, attrs } of deviceListNode.content) {
+                    if (tag === 'device') deviceList.push({ id: +attrs.id, keyIndex: +attrs['key-index'], isHosted: attrs['is_hosted'] === 'true' });
+                }
+            }
+            if (keyIndexNode?.tag === 'key-index-list') {
+                keyIndex = { timestamp: +keyIndexNode.attrs['ts'], signedKeyIndex: keyIndexNode?.content, expectedTimestamp: keyIndexNode.attrs['expected_ts'] ? +keyIndexNode.attrs['expected_ts'] : undefined };
+            }
+        }
+        return { deviceList, keyIndex };
+    }
+}

package/lib/WAUSync/Protocols/USyncDisappearingModeProtocol.js

@@ -0,0 +1,15 @@
+import { assertNodeErrorFree } from '../../WABinary/index.js';
+
+export class USyncDisappearingModeProtocol {
+    constructor() { this.name = 'disappearing_mode'; }
+
+    getQueryElement() { return { tag: 'disappearing_mode', attrs: {} }; }
+
+    getUserElement() { return null; }
+
+    parser(node) {
+        if (node.tag !== 'disappearing_mode') return;
+        assertNodeErrorFree(node);
+        return { duration: +node.attrs.duration, setAt: new Date(+(node.attrs.t || 0) * 1000) };
+    }
+}

package/lib/WAUSync/Protocols/USyncFeatureProtocol.js

@@ -0,0 +1,24 @@
+import { getBinaryNodeChild } from '../../WABinary/index.js';
+
+export const USYNC_FEATURES = ['document', 'encrypt', 'encrypt_blist', 'encrypt_contact', 'encrypt_group_gen2', 'encrypt_image', 'encrypt_location', 'encrypt_url', 'encrypt_v2', 'voip', 'voip_legacy', 'multi_agent', 'bot_eligible'];
+
+const CAMEL_MAP = { encrypt_v2: 'encryptV2', voip_legacy: 'voipLegacy', multi_agent: 'multiAgent', bot_eligible: 'botEligible', encrypt_blist: 'encryptBlist', encrypt_contact: 'encryptContact', encrypt_group_gen2: 'encryptGroupGen2', encrypt_image: 'encryptImage', encrypt_location: 'encryptLocation', encrypt_url: 'encryptUrl' };
+
+export class USyncFeatureProtocol {
+    constructor(features) { this.name = 'feature'; this.features = features?.length ? features : USYNC_FEATURES; }
+
+    getQueryElement() { return { tag: 'feature', attrs: {}, content: this.features.map(f => ({ tag: f, attrs: {} })) }; }
+
+    getUserElement() { return null; }
+
+    parser(node) {
+        if (node.tag !== 'feature') return null;
+        const errorNode = getBinaryNodeChild(node, 'error');
+        if (errorNode) return { errorCode: errorNode.attrs?.code ? +errorNode.attrs.code : undefined, errorText: errorNode.attrs?.text };
+        const features = {};
+        for (const child of (Array.isArray(node.content) ? node.content : [])) {
+            if (child?.attrs && child.attrs.value !== undefined) features[CAMEL_MAP[child.tag] || child.tag] = child.attrs.value;
+        }
+        return features;
+    }
+}

package/lib/WAUSync/Protocols/USyncLIDProtocol.js

@@ -0,0 +1,9 @@
+export class USyncLIDProtocol {
+    constructor() { this.name = 'lid'; }
+
+    getQueryElement() { return { tag: 'lid', attrs: {} }; }
+
+    getUserElement(user) { return user.lid ? { tag: 'lid', attrs: { jid: user.lid } } : null; }
+
+    parser(node) { return node.tag === 'lid' ? node.attrs.val : null; }
+}

package/lib/WAUSync/Protocols/USyncPictureProtocol.js

@@ -0,0 +1,21 @@
+import { assertNodeErrorFree } from '../../WABinary/index.js';
+
+export class USyncPictureProtocol {
+    constructor(type = 'image') { this.name = 'picture'; this.type = type; }
+
+    getQueryElement() { return { tag: 'picture', attrs: { type: this.type } }; }
+
+    getUserElement(user) {
+        const attrs = {};
+        if (user.pictureId != null) attrs.id = String(user.pictureId);
+        return Object.keys(attrs).length > 0 ? { tag: 'picture', attrs } : null;
+    }
+
+    parser(node) {
+        if (node.tag !== 'picture') return null;
+        assertNodeErrorFree(node);
+        const id = node.attrs?.id ?? null, directPath = node.attrs?.direct_path ?? null, hash = node.attrs?.hash ?? null;
+        if (!id && !directPath) return null;
+        return { id, directPath, hash };
+    }
+}

package/lib/WAUSync/Protocols/USyncSidelistProtocol.js

@@ -0,0 +1,19 @@
+import { assertNodeErrorFree } from '../../WABinary/index.js';
+
+export class USyncSidelistProtocol {
+    constructor(useLidAddressing = true) { this.name = 'sidelist'; this.useLidAddressing = useLidAddressing; }
+
+    getQueryElement() {
+        const attrs = {};
+        if (this.useLidAddressing) attrs.addressing_mode = 'lid';
+        return { tag: 'sidelist', attrs };
+    }
+
+    getUserElement(user) { return user.sidelistDelete ? { tag: 'sidelist', attrs: { type: 'delete' } } : null; }
+
+    parser(node) {
+        if (node.tag !== 'sidelist' && node.tag !== 'side_list') return null;
+        assertNodeErrorFree(node);
+        return { type: node.attrs?.type ?? null };
+    }
+}

package/lib/WAUSync/Protocols/USyncStatusProtocol.js

@@ -0,0 +1,19 @@
+import { assertNodeErrorFree } from '../../WABinary/index.js';
+
+export class USyncStatusProtocol {
+    constructor() { this.name = 'status'; }
+
+    getQueryElement() { return { tag: 'status', attrs: {} }; }
+
+    getUserElement() { return null; }
+
+    parser(node) {
+        if (node.tag !== 'status') return;
+        assertNodeErrorFree(node);
+        const setAt = new Date(+(node.attrs.t || 0) * 1000);
+        let status = node.content?.toString() ?? null;
+        if (!status) status = (node.attrs?.code && +node.attrs.code === 401) ? '' : null;
+        else if (status.length === 0) status = null;
+        return { status, setAt };
+    }
+}

package/lib/WAUSync/Protocols/USyncTextStatusProtocol.js

@@ -0,0 +1,22 @@
+import { assertNodeErrorFree, getBinaryNodeChild } from '../../WABinary/index.js';
+
+export class USyncTextStatusProtocol {
+    constructor() { this.name = 'text_status'; }
+
+    getQueryElement() { return { tag: 'text_status', attrs: {} }; }
+
+    getUserElement() { return null; }
+
+    parser(node) {
+        if (node.tag !== 'text_status') return null;
+        assertNodeErrorFree(node);
+        const lastUpdateTimeSec    = node.attrs?.last_update_time       ? +node.attrs.last_update_time       : 0;
+        const ephemeralDurationSec = node.attrs?.ephemeral_duration_sec ? +node.attrs.ephemeral_duration_sec : 0;
+        return {
+            text: node.attrs?.text ?? null,
+            emoji: getBinaryNodeChild(node, 'emoji')?.attrs?.content ?? null,
+            setAt: new Date(lastUpdateTimeSec * 1000),
+            expiresAt: ephemeralDurationSec > 0 ? new Date((lastUpdateTimeSec + ephemeralDurationSec) * 1000) : null
+        };
+    }
+}

package/lib/WAUSync/Protocols/USyncUsernameProtocol.js

@@ -0,0 +1,16 @@
+import { assertNodeErrorFree } from '../../WABinary/index.js';
+
+export class USyncUsernameProtocol {
+    constructor() { this.name = 'username'; }
+
+    getQueryElement() { return { tag: 'username', attrs: {} }; }
+
+    getUserElement(user) { void user; return null; }
+
+    parser(node) {
+        if (node.tag !== 'username') return null;
+        assertNodeErrorFree(node);
+        const username = node.content != null ? node.content.toString() : null;
+        return username && username.length > 0 ? username : null;
+    }
+}

package/lib/WAUSync/Protocols/index.js

@@ -0,0 +1,12 @@
+export * from './USyncDeviceProtocol.js';
+export * from './USyncContactProtocol.js';
+export * from './USyncStatusProtocol.js';
+export * from './USyncDisappearingModeProtocol.js';
+export * from './USyncUsernameProtocol.js';
+export * from './USyncBotProfileProtocol.js';
+export * from './USyncLIDProtocol.js';
+export * from './USyncBusinessProtocol.js';
+export * from './USyncPictureProtocol.js';
+export * from './USyncTextStatusProtocol.js';
+export * from './USyncSidelistProtocol.js';
+export * from './USyncFeatureProtocol.js';

package/lib/WAUSync/USyncQuery.js

@@ -0,0 +1,100 @@
+import { getBinaryNodeChild } from '../WABinary/index.js';
+import { USyncContactProtocol }          from './Protocols/USyncContactProtocol.js';
+import { USyncDeviceProtocol }            from './Protocols/USyncDeviceProtocol.js';
+import { USyncDisappearingModeProtocol }  from './Protocols/USyncDisappearingModeProtocol.js';
+import { USyncStatusProtocol }            from './Protocols/USyncStatusProtocol.js';
+import { USyncUsernameProtocol }          from './Protocols/USyncUsernameProtocol.js';
+import { USyncBotProfileProtocol }        from './Protocols/USyncBotProfileProtocol.js';
+import { USyncLIDProtocol }               from './Protocols/USyncLIDProtocol.js';
+import { USyncBusinessProtocol }          from './Protocols/USyncBusinessProtocol.js';
+import { USyncPictureProtocol }           from './Protocols/USyncPictureProtocol.js';
+import { USyncTextStatusProtocol }        from './Protocols/USyncTextStatusProtocol.js';
+import { USyncSidelistProtocol }          from './Protocols/USyncSidelistProtocol.js';
+import { USyncFeatureProtocol }           from './Protocols/USyncFeatureProtocol.js';
+
+export class USyncQuery {
+    constructor() { this.protocols = []; this.users = []; this.context = 'interactive'; this.mode = 'query'; }
+
+    withMode(mode)         { this.mode = mode; return this; }
+    withContext(context)   { this.context = context; return this; }
+    withUser(user)         { this.users.push(user); return this; }
+
+    parseUSyncQueryResult(result) {
+        if (!result || result.attrs.type !== 'result') return;
+
+        const protocolMap  = Object.fromEntries(this.protocols.map(p => [p.name, p.parser.bind(p)]));
+        const queryResult  = { errors: {}, refresh: {}, list: [], sideList: [] };
+        const usyncNode    = getBinaryNodeChild(result, 'usync');
+
+        // Collect per-protocol errors and refresh hints from the result node
+        const resultNode = usyncNode ? getBinaryNodeChild(usyncNode, 'result') : undefined;
+        if (resultNode) {
+            for (const protocol of this.protocols) {
+                const pNode     = getBinaryNodeChild(resultNode, protocol.name);
+                if (!pNode) continue;
+                const errorNode = getBinaryNodeChild(pNode, 'error');
+                if (errorNode) queryResult.errors[protocol.name] = { errorCode: errorNode.attrs.code ? +errorNode.attrs.code : undefined, errorText: errorNode.attrs.text, errorBackoff: errorNode.attrs.backoff ? +errorNode.attrs.backoff : undefined };
+                else if (pNode.attrs.refresh !== undefined) queryResult.refresh[protocol.name] = +pNode.attrs.refresh;
+            }
+        }
+
+        const parseUserNodes = nodes => nodes.reduce((acc, node) => {
+            const id = node?.attrs?.jid;
+            if (!id) return acc;
+
+            // 401/403/405 on the <user> node means blocked-by
+            const userErrCode      = node.attrs?.error ? parseInt(node.attrs.error, 10) : 0;
+            const isBlockedByAttr  = userErrCode === 401 || userErrCode === 403 || userErrCode === 405;
+
+            const data = Array.isArray(node.content)
+                ? Object.fromEntries(node.content.map(content => {
+                    const tag = content.tag;
+                    // Extract privacy token inline without a registered protocol
+                    if (tag === 'privacy') {
+                        const tokenNode  = getBinaryNodeChild(content, 'token');
+                        const modeTsNode = getBinaryNodeChild(content, 'mode_ts');
+                        const tokenVal   = tokenNode?.content || content.attrs?.token;
+                        if (!tokenVal) return ['privacy', null];
+                        return ['privacy', { token: Buffer.isBuffer(tokenVal) || tokenVal instanceof Uint8Array ? Buffer.from(tokenVal) : tokenVal, modeTs: modeTsNode?.content?.toString?.() || modeTsNode?.attrs?.value || content.attrs?.mode_ts || null }];
+                    }
+                    const parser = protocolMap[tag];
+                    if (!parser) return [tag, null];
+                    try { return [tag, parser(content)]; }
+                    catch (err) {
+                        const code = err?.data ?? err?.output?.payload?.data;
+                        if (code === 401 || code === 403 || code === 405) return ['isBlockedByContact', true];
+                        throw err;
+                    }
+                }).filter(([, v]) => v !== null))
+                : {};
+
+            if (isBlockedByAttr) data.isBlockedByContact = true;
+
+            // Remap snake_case key to camelCase
+            if ('disappearing_mode' in data) { data.disappearingMode = data.disappearing_mode; delete data.disappearing_mode; }
+
+            acc.push({ ...data, id });
+            return acc;
+        }, []);
+
+        const listNode     = usyncNode ? getBinaryNodeChild(usyncNode, 'list')      : undefined;
+        const sideListNode = usyncNode ? getBinaryNodeChild(usyncNode, 'side_list') : undefined;
+        if (listNode?.content     && Array.isArray(listNode.content))     queryResult.list     = parseUserNodes(listNode.content);
+        if (sideListNode?.content && Array.isArray(sideListNode.content)) queryResult.sideList = parseUserNodes(sideListNode.content);
+
+        return queryResult;
+    }
+
+    withDeviceProtocol()                        { this.protocols.push(new USyncDeviceProtocol());                      return this; }
+    withContactProtocol()                       { this.protocols.push(new USyncContactProtocol());                     return this; }
+    withStatusProtocol()                        { this.protocols.push(new USyncStatusProtocol());                      return this; }
+    withDisappearingModeProtocol()              { this.protocols.push(new USyncDisappearingModeProtocol());            return this; }
+    withBotProfileProtocol()                    { this.protocols.push(new USyncBotProfileProtocol());                  return this; }
+    withLIDProtocol()                           { this.protocols.push(new USyncLIDProtocol());                         return this; }
+    withUsernameProtocol()                      { this.protocols.push(new USyncUsernameProtocol());                    return this; }
+    withBusinessProtocol(profileVersion)        { this.protocols.push(new USyncBusinessProtocol(profileVersion));      return this; }
+    withPictureProtocol(type)                   { this.protocols.push(new USyncPictureProtocol(type));                 return this; }
+    withTextStatusProtocol()                    { this.protocols.push(new USyncTextStatusProtocol());                  return this; }
+    withSidelistProtocol(useLidAddressing)      { this.protocols.push(new USyncSidelistProtocol(useLidAddressing));    return this; }
+    withFeatureProtocol(features)               { this.protocols.push(new USyncFeatureProtocol(features));             return this; }
+}

package/lib/WAUSync/USyncUser.js

@@ -0,0 +1,20 @@
+export class USyncUser {
+    withId(id)                         { this.id = id; return this; }
+    withLid(lid)                       { this.lid = lid; return this; }
+    withPhone(phone)                   { this.phone = phone; return this; }
+    withUsername(username)             { this.username = username; return this; }
+    withUsernameKey(usernameKey)       { this.usernameKey = usernameKey; return this; }
+    withType(type)                     { this.type = type; return this; }
+    withPersonaId(personaId)           { this.personaId = personaId; return this; }
+    withPictureId(pictureId)           { this.pictureId = pictureId; return this; }
+    withTcToken(tcToken)               { this.tcToken = tcToken; return this; }
+    withPnJid(pnJid)                   { this.pnJid = pnJid; return this; }
+    withDeviceHash(deviceHash)         { this.deviceHash = deviceHash; return this; }
+    withTs(ts)                         { this.ts = ts; return this; }
+    withExpectedTs(expectedTs)         { this.expectedTs = expectedTs; return this; }
+    withVerifiedNameSerial(serial)     { this.verifiedNameSerial = serial; return this; }
+    withBusinessProfileTag(tag)        { this.businessProfileTag = tag; return this; }
+    withSidelistDelete(del = true)     { this.sidelistDelete = del; return this; }
+    // At least one addressable field required for a valid usync user
+    validate() { return !!(this.id || this.phone || this.username || this.pnJid); }
+}

package/lib/WAUSync/index.js

@@ -0,0 +1,3 @@
+export * from './Protocols/index.js';
+export * from './USyncQuery.js';
+export * from './USyncUser.js';