@realvare/based 2.5.1

package/lib/Utils/noise-handler.d.ts

@@ -0,0 +1,19 @@
+import { ILogger } from './logger';
+import { proto } from '../../WAProto';
+import { KeyPair } from '../Types';
+import { BinaryNode } from '../WABinary';
+export declare const makeNoiseHandler: ({ keyPair: { private: privateKey, public: publicKey }, NOISE_HEADER, logger, routingInfo }: {
+    keyPair: KeyPair;
+    NOISE_HEADER: Uint8Array;
+    logger: ILogger;
+    routingInfo?: Buffer | undefined;
+}) => {
+    encrypt: (plaintext: Uint8Array) => Buffer<ArrayBuffer>;
+    decrypt: (ciphertext: Uint8Array) => Buffer<ArrayBuffer>;
+    authenticate: (data: Uint8Array) => void;
+    mixIntoKey: (data: Uint8Array) => Promise<void>;
+    finishInit: () => Promise<void>;
+    processHandshake: ({ serverHello }: proto.HandshakeMessage, noiseKey: KeyPair) => Promise<Buffer<ArrayBuffer>>;
+    encodeFrame: (data: Buffer | Uint8Array) => Buffer<ArrayBuffer>;
+    decodeFrame: (newData: Buffer | Uint8Array, onFrame: (buff: Uint8Array | BinaryNode) => void) => Promise<void>;
+};

package/lib/Utils/noise-handler.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeNoiseHandler = void 0;
+const boom_1 = require("@hapi/boom");
+const WAProto_1 = require("../../WAProto");
+const Defaults_1 = require("../Defaults");
+const WABinary_1 = require("../WABinary");
+const crypto_1 = require("./crypto");
+const generateIV = (counter) => {
+    const iv = new ArrayBuffer(12);
+    new DataView(iv).setUint32(8, counter);
+    return new Uint8Array(iv);
+};
+const makeNoiseHandler = ({ keyPair: { private: privateKey, public: publicKey }, NOISE_HEADER, logger, routingInfo }) => {
+    logger = logger.child({ class: 'ns' });
+    const authenticate = (data) => {
+        if (!isFinished) {
+            hash = (0, crypto_1.sha256)(Buffer.concat([hash, data]));
+        }
+    };
+    const encrypt = (plaintext) => {
+        const result = (0, crypto_1.aesEncryptGCM)(plaintext, encKey, generateIV(writeCounter), hash);
+        writeCounter += 1;
+        authenticate(result);
+        return result;
+    };
+    const decrypt = (ciphertext) => {
+        // before the handshake is finished, we use the same counter
+        // after handshake, the counters are different
+        const iv = generateIV(isFinished ? readCounter : writeCounter);
+        const result = (0, crypto_1.aesDecryptGCM)(ciphertext, decKey, iv, hash);
+        if (isFinished) {
+            readCounter += 1;
+        }
+        else {
+            writeCounter += 1;
+        }
+        authenticate(ciphertext);
+        return result;
+    };
+    const localHKDF = async (data) => {
+        const key = await (0, crypto_1.hkdf)(Buffer.from(data), 64, { salt, info: '' });
+        return [key.slice(0, 32), key.slice(32)];
+    };
+    const mixIntoKey = async (data) => {
+        const [write, read] = await localHKDF(data);
+        salt = write;
+        encKey = read;
+        decKey = read;
+        readCounter = 0;
+        writeCounter = 0;
+    };
+    const finishInit = async () => {
+        const [write, read] = await localHKDF(new Uint8Array(0));
+        encKey = write;
+        decKey = read;
+        hash = Buffer.from([]);
+        readCounter = 0;
+        writeCounter = 0;
+        isFinished = true;
+    };
+    const data = Buffer.from(Defaults_1.NOISE_MODE);
+    let hash = data.byteLength === 32 ? data : (0, crypto_1.sha256)(data);
+    let salt = hash;
+    let encKey = hash;
+    let decKey = hash;
+    let readCounter = 0;
+    let writeCounter = 0;
+    let isFinished = false;
+    let sentIntro = false;
+    let inBytes = Buffer.alloc(0);
+    authenticate(NOISE_HEADER);
+    authenticate(publicKey);
+    return {
+        encrypt,
+        decrypt,
+        authenticate,
+        mixIntoKey,
+        finishInit,
+        processHandshake: async ({ serverHello }, noiseKey) => {
+            authenticate(serverHello.ephemeral);
+            await mixIntoKey(crypto_1.Curve.sharedKey(privateKey, serverHello.ephemeral));
+            const decStaticContent = decrypt(serverHello.static);
+            await mixIntoKey(crypto_1.Curve.sharedKey(privateKey, decStaticContent));
+            const certDecoded = decrypt(serverHello.payload);
+            const { intermediate: certIntermediate } = WAProto_1.proto.CertChain.decode(certDecoded);
+            const { issuerSerial } = WAProto_1.proto.CertChain.NoiseCertificate.Details.decode(certIntermediate.details);
+            if (issuerSerial !== Defaults_1.WA_CERT_DETAILS.SERIAL) {
+                throw new boom_1.Boom('certification match failed', { statusCode: 400 });
+            }
+            const keyEnc = encrypt(noiseKey.public);
+            await mixIntoKey(crypto_1.Curve.sharedKey(noiseKey.private, serverHello.ephemeral));
+            return keyEnc;
+        },
+        encodeFrame: (data) => {
+            if (isFinished) {
+                data = encrypt(data);
+            }
+            let header;
+            if (routingInfo) {
+                header = Buffer.alloc(7);
+                header.write('ED', 0, 'utf8');
+                header.writeUint8(0, 2);
+                header.writeUint8(1, 3);
+                header.writeUint8(routingInfo.byteLength >> 16, 4);
+                header.writeUint16BE(routingInfo.byteLength & 65535, 5);
+                header = Buffer.concat([header, routingInfo, NOISE_HEADER]);
+            }
+            else {
+                header = Buffer.from(NOISE_HEADER);
+            }
+            const introSize = sentIntro ? 0 : header.length;
+            const frame = Buffer.alloc(introSize + 3 + data.byteLength);
+            if (!sentIntro) {
+                frame.set(header);
+                sentIntro = true;
+            }
+            frame.writeUInt8(data.byteLength >> 16, introSize);
+            frame.writeUInt16BE(65535 & data.byteLength, introSize + 1);
+            frame.set(data, introSize + 3);
+            return frame;
+        },
+        decodeFrame: async (newData, onFrame) => {
+            var _a;
+            // the binary protocol uses its own framing mechanism
+            // on top of the WS frames
+            // so we get this data and separate out the frames
+            const getBytesSize = () => {
+                if (inBytes.length >= 3) {
+                    return (inBytes.readUInt8() << 16) | inBytes.readUInt16BE(1);
+                }
+            };
+            inBytes = Buffer.concat([inBytes, newData]);
+            logger.trace(`recv ${newData.length} bytes, total recv ${inBytes.length} bytes`);
+            let size = getBytesSize();
+            while (size && inBytes.length >= size + 3) {
+                let frame = inBytes.slice(3, size + 3);
+                inBytes = inBytes.slice(size + 3);
+                if (isFinished) {
+                    const result = decrypt(frame);
+                    frame = await (0, WABinary_1.decodeBinaryNode)(result);
+                }
+                logger.trace({ msg: (_a = frame === null || frame === void 0 ? void 0 : frame.attrs) === null || _a === void 0 ? void 0 : _a.id }, 'recv frame');
+                onFrame(frame);
+                size = getBytesSize();
+            }
+        }
+    };
+};
+exports.makeNoiseHandler = makeNoiseHandler;

package/lib/Utils/performance-config.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Configurazione performance per ottimizzazioni LID/JID
+ */
+export interface CacheConfig {
+    ttl: number;
+    maxSize: number;
+    cleanupInterval: number;
+}
+
+export interface PerformanceSettings {
+    enableCache: boolean;
+    enableLogging: boolean;
+    enableMetrics: boolean;
+    batchSize: number;
+    maxRetries: number;
+    retryDelay: number;
+}
+
+export interface DebugSettings {
+    enableLidLogging: boolean;
+    enablePerformanceLogging: boolean;
+    enableErrorLogging: boolean;
+    logLevel: 'error' | 'warn' | 'info' | 'debug';
+}
+
+export interface PerformanceConfigInterface {
+    cache: {
+        lidCache: CacheConfig;
+        jidCache: CacheConfig;
+        lidToJidCache: CacheConfig;
+    };
+    performance: PerformanceSettings;
+    debug: DebugSettings;
+}
+
+export declare class PerformanceConfig implements PerformanceConfigInterface {
+    cache: {
+        lidCache: CacheConfig;
+        jidCache: CacheConfig;
+        lidToJidCache: CacheConfig;
+    };
+    performance: PerformanceSettings;
+    debug: DebugSettings;
+    
+    updateCacheConfig(cacheType: string, config: Partial<CacheConfig>): void;
+    updatePerformanceConfig(config: Partial<PerformanceSettings>): void;
+    updateDebugConfig(config: Partial<DebugSettings>): void;
+    shouldLog(level: string): boolean;
+}
+
+export declare class Logger {
+    static error(message: string, ...args: any[]): void;
+    static warn(message: string, ...args: any[]): void;
+    static info(message: string, ...args: any[]): void;
+    static debug(message: string, ...args: any[]): void;
+    static performance(message: string, ...args: any[]): void;
+}
+
+export declare const getPerformanceConfig: () => PerformanceConfig;
+export declare const setPerformanceConfig: (config: Partial<PerformanceConfigInterface> | PerformanceConfig) => void;

package/lib/Utils/performance-config.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerformanceConfig = exports.setPerformanceConfig = exports.getPerformanceConfig = void 0;
+
+/**
+ * Configurazione performance per ottimizzazioni LID/JID
+ */
+class PerformanceConfig {
+    constructor() {
+        // Cache settings
+        this.cache = {
+            lidCache: {
+                ttl: 5 * 60 * 1000, // 5 minuti
+                maxSize: 10000,
+                cleanupInterval: 2 * 60 * 1000 // 2 minuti
+            },
+            jidCache: {
+                ttl: 5 * 60 * 1000, // 5 minuti
+                maxSize: 10000,
+                cleanupInterval: 2 * 60 * 1000 // 2 minuti
+            },
+            lidToJidCache: {
+                ttl: 5 * 60 * 1000, // 5 minuti
+                maxSize: 5000,
+                cleanupInterval: 3 * 60 * 1000 // 3 minuti
+            }
+        };
+        
+        // Performance settings
+        this.performance = {
+            enableCache: true,
+            enableLogging: false,
+            enableMetrics: false,
+            batchSize: 100,
+            maxRetries: 3,
+            retryDelay: 1000
+        };
+        
+        // Debug settings
+        this.debug = {
+            enableLidLogging: process.env.DEBUG_LID === 'true',
+            enablePerformanceLogging: process.env.DEBUG_PERFORMANCE === 'true',
+            enableErrorLogging: true,
+            logLevel: process.env.LOG_LEVEL || 'error'
+        };
+    }
+    
+    /**
+     * Aggiorna configurazione cache
+     */
+    updateCacheConfig(cacheType, config) {
+        if (this.cache[cacheType]) {
+            this.cache[cacheType] = { ...this.cache[cacheType], ...config };
+        }
+    }
+    
+    /**
+     * Aggiorna configurazione performance
+     */
+    updatePerformanceConfig(config) {
+        this.performance = { ...this.performance, ...config };
+    }
+    
+    /**
+     * Aggiorna configurazione debug
+     */
+    updateDebugConfig(config) {
+        this.debug = { ...this.debug, ...config };
+    }
+    
+    /**
+     * Verifica se il logging è abilitato per un livello specifico
+     */
+    shouldLog(level) {
+        const levels = ['error', 'warn', 'info', 'debug'];
+        const currentLevelIndex = levels.indexOf(this.debug.logLevel);
+        const requestedLevelIndex = levels.indexOf(level);
+        return requestedLevelIndex <= currentLevelIndex;
+    }
+}
+
+// Istanza globale della configurazione
+let globalConfig = new PerformanceConfig();
+
+/**
+ * Ottieni la configurazione performance globale
+ */
+const getPerformanceConfig = () => globalConfig;
+exports.getPerformanceConfig = getPerformanceConfig;
+
+/**
+ * Imposta una nuova configurazione performance
+ */
+const setPerformanceConfig = (config) => {
+    if (config instanceof PerformanceConfig) {
+        globalConfig = config;
+    } else {
+        // Merge con configurazione esistente
+        if (config.cache) {
+            Object.keys(config.cache).forEach(key => {
+                globalConfig.updateCacheConfig(key, config.cache[key]);
+            });
+        }
+        if (config.performance) {
+            globalConfig.updatePerformanceConfig(config.performance);
+        }
+        if (config.debug) {
+            globalConfig.updateDebugConfig(config.debug);
+        }
+    }
+};
+exports.setPerformanceConfig = setPerformanceConfig;
+
+/**
+ * Utility per logging condizionale
+ */
+class Logger {
+    static error(message, ...args) {
+        if (globalConfig.shouldLog('error')) {
+            console.error(`[LID/JID Error] ${message}`, ...args);
+        }
+    }
+    
+    static warn(message, ...args) {
+        if (globalConfig.shouldLog('warn')) {
+            console.warn(`[LID/JID Warning] ${message}`, ...args);
+        }
+    }
+    
+    static info(message, ...args) {
+        if (globalConfig.shouldLog('info')) {
+            console.info(`[LID/JID Info] ${message}`, ...args);
+        }
+    }
+    
+    static debug(message, ...args) {
+        if (globalConfig.shouldLog('debug')) {
+            console.debug(`[LID/JID Debug] ${message}`, ...args);
+        }
+    }
+    
+    static performance(message, ...args) {
+        if (globalConfig.debug.enablePerformanceLogging) {
+            console.log(`[LID/JID Performance] ${message}`, ...args);
+        }
+    }
+}
+
+exports.Logger = Logger;
+exports.PerformanceConfig = PerformanceConfig;

package/lib/Utils/process-message.d.ts

@@ -0,0 +1,42 @@
+import { AxiosRequestConfig } from 'axios';
+import { proto } from '../../WAProto';
+import { AuthenticationCreds, BaileysEventEmitter, CacheStore, SignalKeyStoreWithTransaction, SocketConfig } from '../Types';
+import { ILogger } from './logger';
+type ProcessMessageContext = {
+    shouldProcessHistoryMsg: boolean;
+    placeholderResendCache?: CacheStore;
+    creds: AuthenticationCreds;
+    keyStore: SignalKeyStoreWithTransaction;
+    ev: BaileysEventEmitter;
+    getMessage: SocketConfig['getMessage'];
+    logger?: ILogger;
+    options: AxiosRequestConfig<{}>;
+};
+/** Cleans a received message to further processing */
+export declare const cleanMessage: (message: proto.IWebMessageInfo, meId: string) => void;
+export declare const isRealMessage: (message: proto.IWebMessageInfo, meId: string) => boolean | undefined;
+export declare const shouldIncrementChatUnread: (message: proto.IWebMessageInfo) => boolean;
+/**
+ * Get the ID of the chat from the given key.
+ * Typically -- that'll be the remoteJid, but for broadcasts, it'll be the participant
+ */
+export declare const getChatId: ({ remoteJid, participant, fromMe }: proto.IMessageKey) => string;
+type PollContext = {
+    /** normalised jid of the person that created the poll */
+    pollCreatorJid: string;
+    /** ID of the poll creation message */
+    pollMsgId: string;
+    /** poll creation message enc key */
+    pollEncKey: Uint8Array;
+    /** jid of the person that voted */
+    voterJid: string;
+};
+/**
+ * Decrypt a poll vote
+ * @param vote encrypted vote
+ * @param ctx additional info about the poll required for decryption
+ * @returns list of SHA256 options
+ */
+export declare function decryptPollVote({ encPayload, encIv }: proto.Message.IPollEncValue, { pollCreatorJid, pollMsgId, pollEncKey, voterJid, }: PollContext): proto.Message.PollVoteMessage;
+declare const processMessage: (message: proto.IWebMessageInfo, { shouldProcessHistoryMsg, placeholderResendCache, ev, creds, keyStore, logger, options, getMessage }: ProcessMessageContext) => Promise<void>;
+export default processMessage;