kage-baileys 1.1.1 → 1.1.5

package/Example/connection.cjs

@@ -0,0 +1,100 @@
+'use strict';
+// Node.js >=20.18.1 (recommended: Node.js 22 LTS).
+// Run from the project directory with: npm run example
+const path = require('path');
+const fs = require('fs');
+const pino = require('pino');
+const qrcode = require('qrcode-terminal');
+const { default: makeWASocket, useMultiFileAuthState, makeCacheableSignalKeyStore, makeInMemoryStore, Browsers } = require('../lib');
+const logger = pino({ level: process.env.LOG_LEVEL || 'info' });
+const dataDir = path.resolve(process.env.KAGE_DATA_DIR || './data');
+fs.mkdirSync(dataDir, { recursive: true, mode: 0o700 });
+const storeFile = path.join(dataDir, 'store.json');
+const store = makeInMemoryStore({ logger });
+// Restore local chats and messages immediately, before waiting for network history.
+store.readFromFile(storeFile);
+let sock, auth, attempts = 0, reconnectTimer, saveTimer, shuttingDown = false;
+let credsWrite = Promise.resolve();
+const terminalCodes = new Set([401, 403, 411, 419, 440, 500]);
+function persistSoon() {
+    if (saveTimer || shuttingDown) return;
+    saveTimer = setTimeout(() => {
+        saveTimer = undefined;
+        store.writeToFileAsync(storeFile).catch(error => logger.error({ error }, 'No se pudo guardar el historial'));
+    }, 2000);
+    saveTimer.unref();
+}
+async function connect() {
+    if (shuttingDown) return;
+    auth ||= await useMultiFileAuthState(path.join(dataDir, 'auth'));
+    sock = makeWASocket({
+        logger,
+        auth: { creds: auth.state.creds, keys: makeCacheableSignalKeyStore(auth.state.keys, logger) },
+        browser: Browsers.macOS('Desktop'),
+        syncFullHistory: process.env.KAGE_FULL_HISTORY !== '0',
+        shouldSyncHistoryMessage: () => true,
+        markOnlineOnConnect: false,
+        // Releases the initial wait sooner if the server sends no history notification.
+        // This does not accelerate server downloads and does not disable app-state sync.
+        initialSyncTimeoutMs: 5000,
+        getMessage: async key => (await store.loadMessage(key.remoteJid, key.id))?.message
+    });
+    store.bind(sock.ev);
+    sock.ev.on('creds.update', () => {
+        credsWrite = credsWrite.then(() => auth.saveCreds()).catch(error => {
+            logger.error({ error }, 'Error de escritura de credenciales; se detiene para no perder la sesión');
+            shutdown(1).catch(fatal => { logger.error({ fatal }); process.exitCode = 1; });
+        });
+    });
+    sock.ev.on('messaging-history.set', ({ chats, contacts, messages, progress }) => {
+        logger.info({ chats: chats.length, contacts: contacts.length, messages: messages.length, progress }, 'Historial recibido');
+        persistSoon();
+    });
+    sock.ev.on('messages.upsert', ({ messages, type }) => {
+        // Never wait for all history to process incoming live messages.
+        for (const message of messages) logger.debug({ key: message.key, type }, 'Mensaje recibido');
+        persistSoon();
+    });
+    for (const event of ['messages.update', 'messages.delete', 'chats.update', 'chats.upsert', 'chats.delete', 'contacts.update', 'contacts.upsert']) {
+        sock.ev.on(event, persistSoon);
+    }
+    sock.ev.on('connection.update', ({ connection, qr, lastDisconnect }) => {
+        if (qr) qrcode.generate(qr, { small: true });
+        if (connection === 'open') {
+            logger.info('Conectado. Los datos locales ya están disponibles; el historial remoto llega de forma asíncrona.');
+            // Reset backoff only after a stable connection to prevent rapid open/close loops.
+            const currentSocket = sock;
+            const stable = setTimeout(() => { if (sock === currentSocket && !shuttingDown) attempts = 0; }, 60000);
+            stable.unref();
+        }
+        if (connection !== 'close' || shuttingDown) return;
+        const error = lastDisconnect?.error;
+        const code = error?.output?.statusCode ?? error?.statusCode;
+        if (terminalCodes.has(code) || attempts >= 8) {
+            logger.error({ code, attempts }, 'Reconexión detenida. Revisa la cuenta o sesión manualmente; no se borran credenciales.');
+            shutdown(1).catch(fatal => { logger.error({ fatal }); process.exitCode = 1; });
+            return;
+        }
+        const delay = code === 515 ? 1000 : Math.min(60000, 2000 * 2 ** attempts) + Math.floor(Math.random() * 1000);
+        attempts++;
+        clearTimeout(reconnectTimer);
+        logger.warn({ code, delay, attempts }, 'Reconexión limitada con espera progresiva');
+        reconnectTimer = setTimeout(() => connect().catch(fatal => {
+            logger.error({ fatal }, 'No se pudo reconectar');
+            shutdown(1).catch(error => { logger.error({ error }); process.exitCode = 1; });
+        }), delay);
+    });
+}
+async function shutdown(code = 0) {
+    if (shuttingDown) return;
+    shuttingDown = true;
+    clearTimeout(reconnectTimer); clearTimeout(saveTimer);
+    sock?.end(new Error('Cierre solicitado'));
+    await store.writeToFileAsync(storeFile);
+    // No logout(): closing the example must not unlink the device.
+    process.exitCode = code;
+}
+for (const signal of ['SIGINT', 'SIGTERM']) process.once(signal, () => {
+    shutdown().catch(error => { logger.error({ error }); process.exitCode = 1; });
+});
+connect().catch(error => { logger.error({ error }, 'Error de arranque; conserva tu carpeta de sesión y revisa el problema'); process.exitCode = 1; });

package/Example/event.cjs

@@ -0,0 +1,20 @@
+'use strict';
+// Import this helper in your bot; it does not connect or send by itself.
+async function sendEvent(conn, jid, options = {}) {
+    const startTime = options.startTime ?? String(Math.floor(Date.now() / 1000) + 86400);
+    const eventMessage = {
+        contextInfo: {},
+        isCanceled: false,
+        name: options.name || 'Texto',
+        location: options.location || { degreesLatitude: 0, degreesLongitude: 0 },
+        startTime,
+        extraGuestsAllowed: false,
+        isScheduleCall: false,
+        hasReminder: true,
+        reminderOffsetSec: '3600'
+    };
+    // The library prepares the missing MessageContextInfo.messageSecret.
+    // For local persistence / reply-to events, prefer conn.sendMessage(jid, { event: eventMessage }).
+    return conn.relayMessage(jid, { eventMessage }, {});
+}
+module.exports = { sendEvent };

package/MANTENIMIENTO.txt

@@ -0,0 +1,54 @@
+KAGE BAILEYS 1.1.4 — MANTENIMIENTO
+Fecha de validación: 2026-10-21
+
+ALCANCE REAL
+Proyecto completo, no un parche aislado. Se conservan los módulos originales de botones, álbumes, newsletters, Meta AI, comunidades y VoIP. Conservarlos no significa que se hayan verificado contra WhatsApp. Las pruebas incluidas son locales y no utilizan una cuenta real. No se garantiza funcionamiento perpetuo, compatibilidad con cualquier dependencia ni ausencia de restricciones de cuenta.
+
+INSTALACIÓN
+Se requiere Node.js >=20.18.1. Recomendado Node.js 22 LTS.
+Dentro de la carpeta kage-baileys:
+  npm ci --omit=optional
+  npm run check
+  npm run example
+No se incluyen node_modules ni credenciales. package-lock.json fija las versiones resueltas. Para uso como dependencia local: npm install /ruta/a/kage-baileys
+Para instalar solo el núcleo: npm ci --omit=optional --omit=dev
+Opcionales nativos: sharp, audio-decode, @roamhq/wrtc y whatsapp-rust-bridge pueden requerir instalación específica para la plataforma. FFmpeg debe estar instalado para las funciones que ejecutan el binario. No se han probado llamadas reales ni todos los módulos opcionales.
+
+ESQUEMA ÚNICO
+WAProto/WAProto.proto es la única fuente. Se eliminaron WAProto.kage-original.proto e index.kage-original.js para evitar divergencias. Se regeneraron index.js e index.d.ts con protobufjs 8.8.1 y protobufjs-cli 2.7.1.
+Se restauraron campos de avatar de bot, dominios de clave multimedia, parámetros de pago y asociaciones de difusión.
+El tag 114 antiguo de pollResultSnapshotMessageV3 se conserva como pollResultSnapshotMessageV3Legacy; el tag 115 sigue siendo el nombre canónico. No se inventan ni duplican tags. Para enviar al protocolo actual, utiliza el nombre canónico.
+oldestMessageTimestamp conserva compatibilidad JavaScript con oldestMessageTimestampInWindow (tag 2). Los nombres de enum antiguos también se conservan.
+maintenance/schema-coverage.json verifica todos los tipos, campos, números y valores enum de ambos esquemas fuente, con estas dos excepciones explícitas y sin errores de cobertura.
+Regeneración reproducible: npm run gen:protobuf. Tipos públicos: npm run gen:types. Los extras JavaScript mantienen tipos any; no se presenta esto como tipado estricto de todos los módulos.
+
+EVENTOS
+relayMessage(jid, { eventMessage: {...} }, {}) y sendMessage(jid, { event: {...} }) preparan MessageContextInfo.messageSecret de 32 bytes. Se preservan secretos aportados y se validan nombre, timestamps, booleanos, coordenadas y recordatorio. No se regeneran claves existentes.
+Se conservan hasReminder y reminderOffsetSec, además de los valores false. Un recordatorio activado sin offset utiliza 3600 segundos. El cliente receptor y el servidor deciden el soporte y la visualización final.
+El valor 1792544400 corresponde a 2026-10-21T01:00:00.000Z; es una fecha fija, no la hora actual. Para nuevos eventos usa un timestamp futuro en segundos. No se rechazan eventos pasados válidos, para permitir historial y ediciones.
+Example/event.cjs contiene un helper que usa relayMessage. Example/connection.cjs restaura el almacén y proporciona getMessage para reintentos. Para conservar eventos propios automáticamente, se recomienda sendMessage({ event }).
+Se corrigen menciones y mezcla de contextInfo sin copiar el mensaje completo dentro de contextInfo.
+
+HISTORIAL Y LATENCIA
+El store ya no descarta ON_DEMAND. Los fragmentos históricos se fusionan por defecto para no borrar mensajes recibidos en vivo. Para recuperar el borrado antiguo: makeInMemoryStore({ resetOnHistorySync: true }).
+El procesamiento no muta las conversaciones recibidas, evita filas malformadas y selecciona el mensaje más reciente por timestamp.
+Las escrituras del store preservan buffers y son atómicas. Nuevo writeToFileAsync serializa escrituras a disco. El ejemplo carga los datos guardados antes de esperar al servidor y guarda con debounce.
+Se corrige flush(true) para no dejar el contador de eventos atascado. initialSyncTimeoutMs es configurable; por defecto conserva 20000 ms, el ejemplo utiliza 5000 ms. No se fuerzan flush automáticos que rompan la sincronización de claves.
+No se puede obtener historial remoto instantáneo: depende de WhatsApp, la conexión, la cuenta y el volumen. Si no existe caché local, la primera descarga necesita tiempo.
+
+SESIÓN Y RECONEXIÓN
+Los archivos de autenticación se guardan con temporal + rename y permisos restrictivos en archivos nuevos. Una sesión corrupta ahora produce un error explícito; no se genera silenciosamente una identidad nueva. Conserva una copia de seguridad cifrada de tu carpeta de sesión.
+El ejemplo limita reconexiones a ocho intentos, usa espera exponencial y se detiene ante cierre de sesión, prohibición, sesión reemplazada o sesión inválida. No borra credenciales ni ejecuta logout al cerrar. Esto reduce bucles accidentales, no evita medidas de WhatsApp. No hagas spam ni contactes personas sin consentimiento.
+
+DEPENDENCIAS
+Se corrigió la dependencia ESM p-queue mediante la versión CommonJS 6.6.2 y lru-cache 10.4.3. Se actualizaron protobufjs, file-type, Jimp, music-metadata, link-preview-js y uuid; se adaptaron sus rutas y APIs. Jimp funciona como alternativa sin sharp.
+maintenance/dependency-audit.json recoge npm audit --omit=dev --omit=optional. Su alcance es el núcleo instalado, no módulos nativos no instalados; cero avisos conocidos no significa ausencia de toda vulnerabilidad.
+No se ejecuta npm audit fix --force ni se promete compatibilidad con versiones arbitrarias de dependencias. Para reproducibilidad utiliza npm ci y el lockfile.
+
+PRUEBAS Y LÍMITES
+Las pruebas cubren esquema único, campos restaurados, dos tags históricos de encuestas, fechas int64, ejemplo de evento completo, secretos, menciones, otros tipos básicos de mensaje, historia, persistencia, sesión, imágenes, audio, buffering y relay con cifrado simulado.
+No se ha verificado una entrega real, la interfaz de Android/iOS/Web ni los recordatorios programados por WhatsApp. No se conoce el comportamiento de tu cuenta ni las restricciones del servidor.
+
+REFERENCIAS
+https://baileys.wiki/advanced/history-sync
+https://github.com/WhiskeySockets/Baileys/issues/2468

package/WAProto/GenerateStatics.sh

@@ -1,4 +1,4 @@
-yarn pbjs -t static-module -w commonjs -o ./WAProto/index.js ./WAProto/WAProto.proto;
-yarn pbts -o ./WAProto/index.d.ts ./WAProto/index.js;
-
-#protoc --plugin=./node_modules/.bin/protoc-gen-ts_proto --ts_proto_opt=env=node,useOptionals=true,forceLong=long --ts_proto_out=. ./src/Binary/WAMessage.proto;
+#!/bin/sh
+set -eu
+cd "$(dirname "$0")/.."
+node scripts/generate-protobuf.cjs

package/WAProto/WAProto.proto

@@ -621,6 +621,8 @@ message BotMessageSharingInfo {
 }
 
 message BotMetadata {
+    optional BotAvatarMetadata avatarMetadata = 1;
+
     optional string personaId = 2;
     optional BotPluginMetadata pluginMetadata = 3;
     optional BotSuggestedPromptMetadata suggestedPromptMetadata = 4;
@@ -729,6 +731,10 @@ message BotModeSelectionMetadata {
     repeated BotUserSelectionMode mode = 1;
     repeated uint32 overrideMode = 2;
     enum BotUserSelectionMode {
+        option allow_alias = true;
+        UNKNOWN_MODE = 0;
+        REASONING_MODE = 1;
+
         DEFAULT_MODE = 0;
         THINK_HARD_MODE = 1;
     }
@@ -2245,6 +2251,17 @@ message MemberLabel {
 }
 
 message Message {
+    enum MediaKeyDomain {
+        UNSET = 0;
+        E2EE_CHAT = 1;
+        STATUS = 2;
+        CAPI = 3;
+        BOT = 4;
+    }
+
+    // Historical wire tag retained separately; never encode both versions together.
+    optional PollResultSnapshotMessage pollResultSnapshotMessageV3Legacy = 114;
+
     optional string conversation = 1;
     optional SenderKeyDistributionMessage senderKeyDistributionMessage = 2;
     optional ImageMessage imageMessage = 3;
@@ -2389,6 +2406,8 @@ message Message {
     }
     
     message AudioMessage {
+    optional Message.MediaKeyDomain mediaKeyDomain = 23;
+
         optional string url = 1;
         optional string mimetype = 2;
         optional bytes fileSha256 = 3;
@@ -2588,6 +2607,8 @@ message Message {
     }
     
     message DocumentMessage {
+    optional Message.MediaKeyDomain mediaKeyDomain = 22;
+
         optional string url = 1;
         optional string mimetype = 2;
         optional string title = 3;
@@ -2848,6 +2869,8 @@ message Message {
         MESSAGE_ACCESS_STATUS = 8;
     }
     message ImageMessage {
+    optional Message.MediaKeyDomain mediaKeyDomain = 33;
+
         optional string url = 1;
         optional string mimetype = 2;
         optional string caption = 3;
@@ -3143,6 +3166,8 @@ message Message {
     }
     
     message MMSThumbnailMetadata {
+    optional Message.MediaKeyDomain mediaKeyDomain = 8;
+
         optional string thumbnailDirectPath = 1;
         optional bytes thumbnailSha256 = 2;
         optional bytes thumbnailEncSha256 = 3;
@@ -3220,6 +3245,8 @@ message Message {
     }
     
     message PaymentExtendedMetadata {
+    optional string messageParamsJson = 3;
+
         optional uint32 type = 1;
         optional string platform = 2;
     }
@@ -3786,6 +3813,8 @@ message Message {
     }
     
     message StickerMessage {
+    optional Message.MediaKeyDomain mediaKeyDomain = 23;
+
         optional string url = 1;
         optional bytes fileSha256 = 2;
         optional bytes fileEncSha256 = 3;
@@ -3915,6 +3944,8 @@ message Message {
     }
     
     message VideoMessage {
+    optional Message.MediaKeyDomain mediaKeyDomain = 32;
+
         optional string url = 1;
         optional string mimetype = 2;
         optional bytes fileSha256 = 3;
@@ -4792,6 +4823,8 @@ message SyncActionData {
 }
 
 message SyncActionValue {
+    optional BusinessBroadcastAssociationAction businessBroadcastAssociationAction = 65;
+
     optional int64 timestamp = 1;
     optional StarAction starAction = 2;
     optional ContactAction contactAction = 3;

package/WAProto/compat.cjs

@@ -0,0 +1,16 @@
+'use strict';
+module.exports = function applyCompatibility(proto) {
+    const Type = proto.Message.MessageHistoryMetadata;
+    Object.defineProperty(Type.prototype, 'oldestMessageTimestamp', {
+        configurable: true,
+        get() { return this.oldestMessageTimestampInWindow; },
+        set(value) { this.oldestMessageTimestampInWindow = value; }
+    });
+    const fromObject = Type.fromObject;
+    Type.fromObject = function (object) {
+        if (object && object.oldestMessageTimestampInWindow == null && object.oldestMessageTimestamp != null) {
+            object = { ...object, oldestMessageTimestampInWindow: object.oldestMessageTimestamp };
+        }
+        return fromObject.call(this, object);
+    };
+};

package/WAProto/fix-imports.js

@@ -1,81 +1,3 @@
-import { readFileSync, writeFileSync } from 'fs';
-import { exit } from 'process';
-
-const filePath = './index.js'
-
-try {
-  let content = readFileSync(filePath, 'utf8')
-
-  content = content.replace(/import \* as (\$protobuf) from/g, 'import $1 from')
-  content = content.replace(/(['"])protobufjs\/minimal(['"])/g, '$1protobufjs/minimal.js$2')
-
-  const marker = 'const $root = $protobuf.roots["default"] || ($protobuf.roots["default"] = {});\n\n'
-  const longToStringHelper =
-    'function longToString(value, unsigned) {\n' +
-    '\tif (typeof value === "string") {\n' +
-    '\t\treturn value;\n' +
-    '\t}\n' +
-    '\tif (typeof value === "number") {\n' +
-    '\t\treturn String(value);\n' +
-    '\t}\n' +
-    '\tif (!$util.Long) {\n' +
-    '\t\treturn String(value);\n' +
-    '\t}\n' +
-    '\tconst normalized = $util.Long.fromValue(value);\n' +
-    '\tconst prepared = unsigned && normalized && typeof normalized.toUnsigned === "function"\n' +
-    '\t\t? normalized.toUnsigned()\n' +
-    '\t\t: normalized;\n' +
-    '\treturn prepared.toString();\n' +
-    '}\n\n'
-  const longToNumberHelper =
-    'function longToNumber(value, unsigned) {\n' +
-    '\tif (typeof value === "number") {\n' +
-    '\t\treturn value;\n' +
-    '\t}\n' +
-    '\tif (typeof value === "string") {\n' +
-    '\t\tconst numeric = Number(value);\n' +
-    '\t\treturn numeric;\n' +
-    '\t}\n' +
-    '\tif (!$util.Long) {\n' +
-    '\t\treturn Number(value);\n' +
-    '\t}\n' +
-    '\tconst normalized = $util.Long.fromValue(value);\n' +
-    '\tconst prepared = unsigned && normalized && typeof normalized.toUnsigned === "function"\n' +
-    '\t\t? normalized.toUnsigned()\n' +
-    '\t\t: typeof normalized.toSigned === "function"\n' +
-    '\t\t\t? normalized.toSigned()\n' +
-    '\t\t\t: normalized;\n' +
-    '\treturn prepared.toNumber();\n' +
-    '}\n\n'
-
-  if (!content.includes('function longToString(')) {
-    const markerIndex = content.indexOf(marker)
-    if (markerIndex === -1) {
-      throw new Error('Unable to inject Long helpers: marker not found in WAProto index output')
-    }
-
-    content = content.replace(marker, `${marker}${longToStringHelper}${longToNumberHelper}`)
-  } else {
-    const longToStringRegex = /function longToString\(value, unsigned\) {\n[\s\S]*?\n}\n\n/
-    const longToNumberRegex = /function longToNumber\(value, unsigned\) {\n[\s\S]*?\n}\n\n/
-
-    if (!longToStringRegex.test(content) || !longToNumberRegex.test(content)) {
-      throw new Error('Unable to update Long helpers: existing definitions not found')
-    }
-
-    content = content.replace(longToStringRegex, longToStringHelper)
-    content = content.replace(longToNumberRegex, longToNumberHelper)
-  }
-
-  const longPattern = /([ \t]+d\.(\w+) = )o\.longs === String \? \$util\.Long\.prototype\.toString\.call\(m\.\2\) : o\.longs === Number \? new \$util\.LongBits\(m\.\2\.low >>> 0, m\.\2\.high >>> 0\)\.toNumber\((true)?\) : m\.\2;/g
-  content = content.replace(longPattern, (_match, prefix, field, unsignedFlag) => {
-    const unsignedArg = unsignedFlag ? ', true' : ''
-    return `${prefix}o.longs === String ? longToString(m.${field}${unsignedArg}) : o.longs === Number ? longToNumber(m.${field}${unsignedArg}) : m.${field};`
-  })
-
-  writeFileSync(filePath, content, 'utf8')
-  console.log(`✅ Fixed imports in ${filePath}`)
-} catch (error) {
-  console.error(`❌ Error fixing imports: ${error.message}`)
-  exit(1)
-}
+'use strict';
+// CommonJS is generated directly; retained as a backwards-compatible command.
+require('../scripts/generate-protobuf.cjs');