@nerxa/socketon 0.0.0-stage → 1.21.1

package/src/Utils/generics.js

@@ -0,0 +1,375 @@
+import { Boom } from '@hapi/boom';
+import { createHash, randomBytes, randomFillSync } from 'crypto';
+import { proto } from '../../WAProto/index.js';
+const baileysVersion = [2, 3000, 1051456098];
+import { DisconnectReason } from '../Types/index.js';
+import { getAllBinaryNodeChildren } from '../WABinary/index.js';
+import { sha256 } from './crypto.js';
+export const BufferJSON = {
+
+    replacer: (k, value) => {
+        if (Buffer.isBuffer(value) || value instanceof Uint8Array || value?.type === 'Buffer') {
+            return { type: 'Buffer', data: Buffer.from(value?.data || value).toString('base64') };
+        }
+        return value;
+    },
+
+    reviver: (_, value) => {
+        if (typeof value === 'object' && value !== null && value.type === 'Buffer' && typeof value.data === 'string') {
+            return Buffer.from(value.data, 'base64');
+        }
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            const keys = Object.keys(value);
+            if (keys.length > 0 && keys.every(k => !isNaN(parseInt(k, 10)))) {
+                const values = Object.values(value);
+                if (values.every(v => typeof v === 'number')) {
+                    return Buffer.from(values);
+                }
+            }
+        }
+        return value;
+    }
+};
+export const getKeyAuthor = (key, meId = 'me') => (key?.fromMe ? meId : key?.participantAlt || key?.remoteJidAlt || key?.participant || key?.remoteJid) || '';
+export const isStringNullOrEmpty = (value) =>
+
+value == null || value === '';
+export const writeRandomPadMax16 = (msg) => {
+    const pad = randomBytes(1);
+    const padLength = (pad[0] & 0x0f) + 1;
+    return Buffer.concat([msg, Buffer.alloc(padLength, padLength)]);
+};
+export const unpadRandomMax16 = (e) => {
+    const t = new Uint8Array(e);
+    if (0 === t.length) {
+        throw new Error('unpadPkcs7 given empty bytes');
+    }
+    var r = t[t.length - 1];
+    if (r > t.length) {
+        throw new Error(`unpad given ${t.length} bytes, but pad is ${r}`);
+    }
+    return new Uint8Array(t.buffer, t.byteOffset, t.length - r);
+};
+
+export const generateParticipantHashV2 = (participants) => {
+    participants.sort();
+    const sha256Hash = sha256(Buffer.from(participants.join(''))).toString('base64');
+    return '2:' + sha256Hash.slice(0, 6);
+};
+export const encodeWAMessage = (message) => writeRandomPadMax16(proto.Message.encode(message).finish());
+export const generateRegistrationId = () => {
+    return Uint16Array.from(randomBytes(2))[0] & 16383;
+};
+export const encodeBigEndian = (e, t = 4) => {
+    let r = e;
+    const a = new Uint8Array(t);
+    for (let i = t - 1; i >= 0; i--) {
+        a[i] = 255 & r;
+        r >>>= 8;
+    }
+    return a;
+};
+export const toNumber = (t) => typeof t === 'object' && t ? ('toNumber' in t ? t.toNumber() : t.low) : t || 0;
+
+export const unixTimestampSeconds = (date = new Date()) => date.getTime() / 1000 | 0;
+export const debouncedTimeout = (intervalMs = 1000, task) => {
+    let timeout;
+    return {
+        start: (newIntervalMs, newTask) => {
+            task = newTask || task;
+            intervalMs = newIntervalMs || intervalMs;
+            timeout && clearTimeout(timeout);
+            timeout = setTimeout(() => task?.(), intervalMs);
+        },
+        cancel: () => {
+            timeout && clearTimeout(timeout);
+            timeout = undefined;
+        },
+        setTask: (newTask) => (task = newTask),
+        setInterval: (newInterval) => (intervalMs = newInterval)
+    };
+};
+export const delay = (ms) => delayCancellable(ms).delay;
+export const delayCancellable = (ms) => {
+    const stack = new Error().stack;
+    let timeout;
+    let reject;
+    const delay = new Promise((resolve, _reject) => {
+        timeout = setTimeout(resolve, ms);
+        reject = _reject;
+    });
+    const cancel = () => {
+        clearTimeout(timeout);
+        reject(new Boom('Cancelled', {
+            statusCode: 500,
+            data: {
+                stack
+            }
+        }));
+    };
+    return { delay, cancel };
+};
+export async function promiseTimeout(ms, promise) {
+    if (!ms) {
+        return new Promise(promise);
+    }
+    const stack = new Error().stack;
+
+    const { delay, cancel } = delayCancellable(ms);
+    const p = new Promise((resolve, reject) => {
+        delay
+            .then(() => reject(new Boom('Timed Out', {
+            statusCode: DisconnectReason.timedOut,
+            data: {
+                stack
+            }
+        })))
+            .catch(err => reject(err));
+        promise(resolve, reject);
+    }).finally(cancel);
+    return p;
+}
+
+export const generateMessageIDV2 = (userId) => {
+    const data = Buffer.allocUnsafe(44);
+    data.writeBigUInt64BE(BigInt(Date.now() / 1000 | 0), 0);
+    if (userId) {
+        const userStr = userId.split('@')[0].split(':')[0];
+        if (userStr) {
+            const len = data.write(userStr, 8);
+            data.write('@c.us', 8 + len);
+        }
+    }
+    randomFillSync(data, 28, 16);
+    const hash = createHash('sha256').update(data).digest();
+    return '3EB0' + hash.toString('hex', 0, 9).toUpperCase();
+};
+
+export const generateMessageID = () => '3EB0' + randomBytes(8).toString('hex').toUpperCase();
+export function bindWaitForEvent(ev, event) {
+    return async (check, timeoutMs) => {
+        let listener;
+        let closeListener;
+        await promiseTimeout(timeoutMs, (resolve, reject) => {
+            closeListener = ({ connection, lastDisconnect }) => {
+                if (connection === 'close') {
+                    reject(lastDisconnect?.error || new Boom('Connection Closed', { statusCode: DisconnectReason.connectionClosed }));
+                }
+            };
+            ev.on('connection.update', closeListener);
+            listener = async (update) => {
+                if (await check(update)) {
+                    resolve();
+                }
+            };
+            ev.on(event, listener);
+        }).finally(() => {
+            ev.off(event, listener);
+            ev.off('connection.update', closeListener);
+        });
+    };
+}
+export const bindWaitForConnectionUpdate = (ev) => bindWaitForEvent(ev, 'connection.update');
+
+export const fetchLatestBaileysVersion = async (options = {}) => {
+    const URL = 'https://raw.githubusercontent.com/noxXza/luna-baileys/main/src/Defaults/index.js';
+    try {
+        const response = await fetch(URL, {
+            dispatcher: options.dispatcher,
+            method: 'GET',
+            headers: options.headers
+        });
+        if (!response.ok) {
+            throw new Boom(`Failed to fetch latest Baileys version: ${response.statusText}`, { statusCode: response.status });
+        }
+        const text = await response.text();
+
+        const lines = text.split('\n');
+        const versionLine = lines[4];
+        const versionMatch = versionLine.match(/const version = \[(\d+),\s*(\d+),\s*(\d+)\]/);
+        if (versionMatch) {
+            const version = [parseInt(versionMatch[1]), parseInt(versionMatch[2]), parseInt(versionMatch[3])];
+            return {
+                version,
+                isLatest: true
+            };
+        }
+        else {
+            throw new Error('Could not parse version from Defaults/index.ts');
+        }
+    }
+    catch (error) {
+        return {
+            version: baileysVersion,
+            isLatest: false,
+            error
+        };
+    }
+};
+
+export const fetchLatestWaWebVersion = async (options = {}) => {
+    try {
+
+        const defaultHeaders = {
+            'sec-fetch-site': 'none',
+            'user-agent': 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36'
+        };
+        const headers = { ...defaultHeaders, ...options.headers };
+        const response = await fetch('https://web.whatsapp.com/sw.js', {
+            ...options,
+            method: 'GET',
+            headers
+        });
+        if (!response.ok) {
+            throw new Boom(`Failed to fetch sw.js: ${response.statusText}`, { statusCode: response.status });
+        }
+        const data = await response.text();
+        const regex = /\\?"client_revision\\?":\s*(\d+)/;
+        const match = data.match(regex);
+        if (!match?.[1]) {
+            return {
+                version: baileysVersion,
+                isLatest: false,
+                error: {
+                    message: 'Could not find client revision in the fetched content'
+                }
+            };
+        }
+        const clientRevision = match[1];
+        return {
+            version: [2, 3000, +clientRevision],
+            isLatest: true
+        };
+    }
+    catch (error) {
+        return {
+            version: baileysVersion,
+            isLatest: false,
+            error
+        };
+    }
+};
+
+export const generateMdTagPrefix = () => {
+    const bytes = randomBytes(4);
+    return `${bytes.readUInt16BE()}.${bytes.readUInt16BE(2)}-`;
+};
+const STATUS_MAP = {
+    sender: proto.WebMessageInfo.Status.SERVER_ACK,
+    played: proto.WebMessageInfo.Status.PLAYED,
+    read: proto.WebMessageInfo.Status.READ,
+    'read-self': proto.WebMessageInfo.Status.READ
+};
+
+export const getStatusFromReceiptType = (type) => {
+    const status = STATUS_MAP[type];
+    if (typeof type === 'undefined') {
+        return proto.WebMessageInfo.Status.DELIVERY_ACK;
+    }
+    return status;
+};
+const CODE_MAP = {
+    conflict: DisconnectReason.connectionReplaced
+};
+
+export const getErrorCodeFromStreamError = (node) => {
+    const [reasonNode] = getAllBinaryNodeChildren(node);
+    let reason = reasonNode?.tag || 'unknown';
+    const statusCode = +(node.attrs.code || CODE_MAP[reason] || DisconnectReason.badSession);
+    if (statusCode === DisconnectReason.restartRequired) {
+        reason = 'restart required';
+    }
+    return {
+        reason,
+        statusCode
+    };
+};
+export const getCallStatusFromNode = ({ tag, attrs }) => {
+    let status;
+    switch (tag) {
+        case 'offer':
+        case 'offer_notice':
+            status = 'offer';
+            break;
+        case 'terminate':
+            if (attrs.reason === 'timeout') {
+                status = 'timeout';
+            }
+            else {
+
+                status = 'terminate';
+            }
+            break;
+        case 'preaccept':
+            status = 'preaccept';
+            break;
+        case 'transport':
+            status = 'transport';
+            break;
+        case 'relaylatency':
+            status = 'relaylatency';
+            break;
+        case 'reject':
+            status = 'reject';
+            break;
+        case 'accept':
+            status = 'accept';
+            break;
+        default:
+            status = 'ringing';
+            break;
+    }
+    return status;
+};
+const UNEXPECTED_SERVER_CODE_TEXT = 'Unexpected server response: ';
+export const getCodeFromWSError = (error) => {
+    let statusCode = 500;
+    if (error?.message?.includes(UNEXPECTED_SERVER_CODE_TEXT)) {
+        const code = +error?.message.slice(UNEXPECTED_SERVER_CODE_TEXT.length);
+        if (!Number.isNaN(code) && code >= 400) {
+            statusCode = code;
+        }
+    }
+    else if (
+
+    error?.code?.startsWith('E') ||
+        error?.message?.includes('timed out')) {
+
+        statusCode = 408;
+    }
+    return statusCode;
+};
+
+export const isWABusinessPlatform = (platform) => {
+    return platform === 'smbi' || platform === 'smba';
+};
+
+export function trimUndefined(obj) {
+    for (const key in obj) {
+        if (typeof obj[key] === 'undefined') {
+            delete obj[key];
+        }
+    }
+    return obj;
+}
+const CROCKFORD_CHARACTERS = '123456789ABCDEFGHJKLMNPQRSTVWXYZ';
+export function bytesToCrockford(buffer) {
+    let value = 0;
+    let bitCount = 0;
+    const crockford = [];
+    for (const element of buffer) {
+        value = (value << 8) | (element & 0xff);
+        bitCount += 8;
+        while (bitCount >= 5) {
+            crockford.push(CROCKFORD_CHARACTERS.charAt((value >>> (bitCount - 5)) & 31));
+            bitCount -= 5;
+        }
+    }
+    if (bitCount > 0) {
+        crockford.push(CROCKFORD_CHARACTERS.charAt((value << (5 - bitCount)) & 31));
+    }
+    return crockford.join('');
+}
+export function encodeNewsletterMessage(message) {
+    return proto.Message.encode(message).finish();
+}

package/src/Utils/group-metadata-cache.d.ts

@@ -0,0 +1,4 @@
+
+export declare const GROUP_ADDRESSING_MODES: readonly string[]
+export declare function isUsableGroupMetadata(metadata: any): boolean
+export declare function describeUnusableGroupMetadata(metadata: any): string

package/src/Utils/group-metadata-cache.js

@@ -0,0 +1,25 @@
+
+export const GROUP_ADDRESSING_MODES = Object.freeze(['pn', 'lid'])
+
+export const isUsableGroupMetadata = metadata => {
+    if (!metadata || typeof metadata !== 'object') {
+        return false
+    }
+    if (!Array.isArray(metadata.participants)) {
+        return false
+    }
+    return GROUP_ADDRESSING_MODES.includes(metadata.addressingMode)
+}
+
+export const describeUnusableGroupMetadata = metadata => {
+    if (!metadata || typeof metadata !== 'object') {
+        return 'nothing cached'
+    }
+    if (!Array.isArray(metadata.participants)) {
+        return 'no participants'
+    }
+    if (metadata.addressingMode === undefined || metadata.addressingMode === null) {
+        return 'no addressingMode'
+    }
+    return `addressingMode ${JSON.stringify(metadata.addressingMode)} is not pn or lid`
+}

package/src/Utils/history.d.ts

@@ -0,0 +1,75 @@
+export function downloadHistory(msg: any, options: any): Promise<proto.HistorySync>;
+export function processHistoryMessage(item: any, logger: any): {
+    chats: any[];
+    contacts: ({
+        id: any;
+        name: any;
+        username: any;
+        lid: any;
+        phoneNumber: any;
+        verifiedName?: undefined;
+        notify?: undefined;
+    } | {
+        id: any;
+        verifiedName: any;
+        name?: undefined;
+        username?: undefined;
+        lid?: undefined;
+        phoneNumber?: undefined;
+        notify?: undefined;
+    } | {
+        id: any;
+        notify: any;
+        name?: undefined;
+        username?: undefined;
+        lid?: undefined;
+        phoneNumber?: undefined;
+        verifiedName?: undefined;
+    })[];
+    messages: any[];
+    lidPnMappings: {
+        lid: any;
+        pn: any;
+    }[];
+    pastParticipants: any;
+    syncType: any;
+    progress: any;
+};
+export function downloadAndProcessHistorySyncNotification(msg: any, options: any, logger: any): Promise<{
+    chats: any[];
+    contacts: ({
+        id: any;
+        name: any;
+        username: any;
+        lid: any;
+        phoneNumber: any;
+        verifiedName?: undefined;
+        notify?: undefined;
+    } | {
+        id: any;
+        verifiedName: any;
+        name?: undefined;
+        username?: undefined;
+        lid?: undefined;
+        phoneNumber?: undefined;
+        notify?: undefined;
+    } | {
+        id: any;
+        notify: any;
+        name?: undefined;
+        username?: undefined;
+        lid?: undefined;
+        phoneNumber?: undefined;
+        verifiedName?: undefined;
+    })[];
+    messages: any[];
+    lidPnMappings: {
+        lid: any;
+        pn: any;
+    }[];
+    pastParticipants: any;
+    syncType: any;
+    progress: any;
+}>;
+export function getHistoryMsg(message: any): any;
+import { proto } from '../../WAProto/index.js';

package/src/Utils/history.js

@@ -0,0 +1,131 @@
+import { pipeline } from 'stream/promises';
+import { promisify } from 'util';
+import { createInflate, inflate } from 'zlib';
+import { proto } from '../../WAProto/index.js';
+import { WAMessageStubType } from '../Types/index.js';
+import { isHostedLidUser, isHostedPnUser, isLidUser, isPnUser } from '../WABinary/index.js';
+import { toNumber } from './generics.js';
+import { normalizeMessageContent } from './messages.js';
+import { downloadContentFromMessage } from './messages-media.js';
+const inflatePromise = promisify(inflate);
+const extractPnFromMessages = (messages) => {
+    for (const msgItem of messages) {
+        const message = msgItem.message;
+
+        if (!message?.key?.fromMe || !message.userReceipt?.length) {
+            continue;
+        }
+        const userJid = message.userReceipt[0]?.userJid;
+        if (userJid && (isPnUser(userJid) || isHostedPnUser(userJid))) {
+            return userJid;
+        }
+    }
+    return undefined;
+};
+export const downloadHistory = async (msg, options) => {
+    const stream = await downloadContentFromMessage(msg, 'md-msg-hist', { options });
+
+    const inflater = createInflate();
+    const chunks = [];
+    inflater.on('data', (chunk) => chunks.push(chunk));
+    await pipeline(stream, inflater);
+    const buffer = Buffer.concat(chunks);
+    const syncData = proto.HistorySync.decode(buffer);
+    return syncData;
+};
+export const processHistoryMessage = (item, logger) => {
+    const messages = [];
+    const contacts = [];
+    const chats = [];
+    const lidPnMappings = [];
+    logger?.trace({ progress: item.progress }, 'processing history of type ' + item.syncType?.toString());
+
+    for (const m of item.phoneNumberToLidMappings || []) {
+        if (m.lidJid && m.pnJid) {
+            lidPnMappings.push({ lid: m.lidJid, pn: m.pnJid });
+        }
+    }
+    switch (item.syncType) {
+        case proto.HistorySync.HistorySyncType.INITIAL_BOOTSTRAP:
+        case proto.HistorySync.HistorySyncType.RECENT:
+        case proto.HistorySync.HistorySyncType.FULL:
+        case proto.HistorySync.HistorySyncType.ON_DEMAND:
+            for (const chat of item.conversations) {
+                contacts.push({
+                    id: chat.id,
+                    name: chat.displayName || chat.name || chat.username || undefined,
+                    username: chat.username || undefined,
+                    lid: chat.lidJid || chat.accountLid || undefined,
+                    phoneNumber: chat.pnJid || undefined
+                });
+                const chatId = chat.id;
+                const isLid = isLidUser(chatId) || isHostedLidUser(chatId);
+                const isPn = isPnUser(chatId) || isHostedPnUser(chatId);
+                if (isLid && chat.pnJid) {
+                    lidPnMappings.push({ lid: chatId, pn: chat.pnJid });
+                }
+                else if (isPn && chat.lidJid) {
+                    lidPnMappings.push({ lid: chat.lidJid, pn: chatId });
+                }
+                else if (isLid && !chat.pnJid) {
+
+                    const pnFromReceipt = extractPnFromMessages(chat.messages || []);
+                    if (pnFromReceipt) {
+                        lidPnMappings.push({ lid: chatId, pn: pnFromReceipt });
+                    }
+                }
+                const msgs = chat.messages || [];
+                delete chat.messages;
+                for (const item of msgs) {
+                    const message = item.message;
+                    messages.push(message);
+                    if (!chat.messages?.length) {
+
+                        chat.messages = [{ message }];
+                    }
+                    if (!message.key.fromMe && !chat.lastMessageRecvTimestamp) {
+                        chat.lastMessageRecvTimestamp = toNumber(message.messageTimestamp);
+                    }
+                    if ((message.messageStubType === WAMessageStubType.BIZ_PRIVACY_MODE_TO_BSP ||
+                        message.messageStubType === WAMessageStubType.BIZ_PRIVACY_MODE_TO_FB) &&
+                        message.messageStubParameters?.[0]) {
+                        contacts.push({
+                            id: message.key.participant || message.key.remoteJid,
+                            verifiedName: message.messageStubParameters?.[0]
+                        });
+                    }
+                }
+                chats.push(chat);
+            }
+            break;
+        case proto.HistorySync.HistorySyncType.PUSH_NAME:
+            for (const c of item.pushnames) {
+                contacts.push({ id: c.id, notify: c.pushname });
+            }
+            break;
+    }
+    return {
+        chats,
+        contacts,
+        messages,
+        lidPnMappings,
+        pastParticipants: item.pastParticipants,
+        syncType: item.syncType,
+        progress: item.progress
+    };
+};
+export const downloadAndProcessHistorySyncNotification = async (msg, options, logger) => {
+    let historyMsg;
+    if (msg.initialHistBootstrapInlinePayload) {
+        historyMsg = proto.HistorySync.decode(await inflatePromise(msg.initialHistBootstrapInlinePayload));
+    }
+    else {
+        historyMsg = await downloadHistory(msg, options);
+    }
+    return processHistoryMessage(historyMsg, logger);
+};
+export const getHistoryMsg = (message) => {
+    const normalizedContent = !!message ? normalizeMessageContent(message) : undefined;
+    const anyHistoryMsg = normalizedContent?.protocolMessage?.historySyncNotification;
+    return anyHistoryMsg;
+};

package/src/Utils/html-app.d.ts

@@ -0,0 +1,19 @@
+export declare const HTML_APP_MESSAGE_CEILING: number
+export declare const HTML_APP_BYTE_BUDGET: number
+export declare const HTML_APP_BYTE_LIMIT: number
+
+export declare function wireBytes(html: string): number
+
+export interface HtmlAppReport {
+    ok: boolean
+    bytes: number
+    wireBytes: number
+    embeddedBytes: number
+    problems: string[]
+    warnings: string[]
+}
+
+export declare function checkHtmlApp(html: string, options?: {
+    height?: number
+    maxBytes?: number
+}): HtmlAppReport