kage-baileys 1.1.9 → 1.1.10

package/WAProto/WAProto.proto

@@ -2290,8 +2290,6 @@ message Message {
     optional DeviceSentMessage deviceSentMessage = 31;
     optional MessageContextInfo messageContextInfo = 35;
     optional ListMessage listMessage = 36;
-    // Kage: preserve the actual wire envelope on receive. Local download/re-upload
-    // helpers live in lib/Utils/view-once.js; no custom protobuf tags are required.
     optional FutureProofMessage viewOnceMessage = 37;
     optional OrderMessage orderMessage = 38;
     optional ListResponseMessage listResponseMessage = 39;

package/lib/Socket/index.js

@@ -8,9 +8,6 @@ const makeWASocket = (config = {}) => {
         ...Defaults_1.DEFAULT_CONNECTION_CONFIG,
         ...config
     });
-    // Unified socket helpers: normal media, view-once re-upload and contact status archives.
-    // Automation stays OFF unless explicitly enabled with kageTools / owner options.
-    const tools = require('../Utils/automation-tools').installKageTools(socket, config.kageTools || {});
-    return tools;
+    return require('../Utils/automation-tools').installKageTools(socket, config.kageTools || {});
 };
 exports.default = makeWASocket;

package/lib/Utils/automation-tools.js

@@ -42,7 +42,7 @@ async function downloadNormalMedia(conn, raw, options = {}) {
       chunks.push(data);
     }
     if (!size) throw new Error('EMPTY_MEDIA: WhatsApp no entregó datos.');
-    return { buffer: Buffer.concat(chunks, size), type: media.type, mimetype: media.value.mimetype || 'application/octet-stream', caption: media.value.caption || '', ptt: !!media.value.ptt, gifPlayback: !!media.value.gifPlayback, fileName: media.value.fileName || '', bytes: size };
+    return { buffer: Buffer.concat(chunks, size), type: media.type, mimetype: media.value.mimetype || 'application/octet-stream', caption: media.value.caption || '', bytes: size };
   })();
   try {
     return await Promise.race([job, new Promise((_, reject) => { timer = setTimeout(() => reject(new Error('MEDIA_TIMEOUT: tiempo de espera agotado.')), timeoutMs); })]);
@@ -95,9 +95,9 @@ function handleAutoMedia(raw, conn, settings = {}, options = {}) {
   state.seen.set(id, now);
   while (state.seen.size > 500) state.seen.delete(state.seen.keys().next().value);
   state.pending++;
-  const job = state.tail.then(() => settings.autoDownloadChats?.includes(raw.key.remoteJid) ? saveNormalMedia(conn, raw, options) : null);
+  const job = state.tail.then(() => saveNormalMedia(conn, raw, options));
   state.tail = job.catch(() => {}).finally(() => { state.pending--; });
-  return job.catch(error => { state.seen.delete(id); throw error; });
+  return job;
 }
 async function sendAIResponse(conn, jid, text, options = {}) {
   if (typeof text !== 'string' || !text.trim()) throw new TypeError('AI response text must be nonempty.');
@@ -113,17 +113,6 @@ function installKageTools(conn, options = {}) {
   Object.defineProperty(conn, '__kageToolsInstalled', { value: true });
   const status = require('./status-tools');
   const country = require('./country-info');
-  const view = require('./view-once');
-  const archives = require('./status-archive');
-  conn.statusContactsOnly = options.contactsOnly !== false;
-  require('./status-contacts').installStatusContacts(conn);
-  conn.getViewOnceContent = view.getViewOnceContent;
-  conn.normalizeViewOnceMessage = view.normalizeViewOnceMessage;
-  conn.downloadViewOnceMessage = (raw, opts) => view.downloadViewOnceMessage(conn, raw, opts);
-  conn.resendViewOnceMessage = (raw, opts) => view.resendViewOnceMessage(conn, raw, opts);
-  conn.handleAutoViewOnce = (raw, settings, opts) => require('./consented-media').handleAutoViewOnce(raw, conn, settings, opts);
-  conn.exportReceivedStatuses = (author, opts) => archives.exportStatusZip(conn, author, opts);
-  conn.saveReceivedStatus = (entry, opts) => archives.saveStatus(conn, entry, opts);
   conn.getReceivedStatuses = (includeUnavailable = false) => status.listStatuses(conn, includeUnavailable);
   conn.reactToReceivedStatus = (entry, emoji) => status.reactToStatus(conn, entry, emoji);
   conn.getCountryForJid = jid => country.getCountryForJid(conn, jid);
@@ -136,7 +125,7 @@ function installKageTools(conn, options = {}) {
   conn.enableStatusTracking = (settings = {}) => {
     if (stop) return stop;
     let active = true;
-    const scopedSettings = new Proxy(settings, { get(target, key) { return ['statusReaction', 'statusSave'].includes(key) ? active && target[key] : target[key]; } });
+    const scopedSettings = new Proxy(settings, { get(target, key) { return key === 'statusReaction' ? active && target[key] : target[key]; } });
     const upsert = event => { for (const raw of event?.messages || []) status.handleStatus(raw, conn, scopedSettings).catch(e => conn.logger?.warn?.({ error: e.message }, 'status tracking')); };
     const deleted = event => { for (const key of event?.keys || []) status.markStatusDeleted(conn, key); };
     const updated = items => { for (const item of items || []) if (item.key?.remoteJid === 'status@broadcast' && item.update?.message === null) status.markStatusDeleted(conn, item.key); };
@@ -156,23 +145,6 @@ function installKageTools(conn, options = {}) {
     };
     return stop;
   };
-  let stopAutomation;
-  conn.enableMediaAutomation = (settings = {}) => {
-    if (stopAutomation) return stopAutomation;
-    const get = () => typeof settings === 'function' ? settings() : settings;
-    const incoming = event => {
-      if (event?.type && event.type !== 'notify') return;
-      for (const raw of event?.messages || []) {
-        handleAutoMedia(raw, conn, get()).catch(error => conn.logger?.warn?.({ error: error.message }, 'auto media'));
-        require('./consented-media').handleAutoViewOnce(raw, conn, get()).catch(error => conn.logger?.warn?.({ error: error.message }, 'auto view once'));
-      }
-    };
-    const closed = update => { if (update.connection === 'close') stopAutomation?.(); };
-    conn.ev.on('messages.upsert', incoming); conn.ev.on('connection.update', closed);
-    stopAutomation = () => { conn.ev.off('messages.upsert', incoming); conn.ev.off('connection.update', closed); stopAutomation = undefined; };
-    return stopAutomation;
-  };
-  if (options.mediaAutomation) conn.enableMediaAutomation(options.mediaSettings || {});
   if (options.statusTracking) conn.enableStatusTracking(options.statusSettings || {});
   return conn;
 }

package/lib/Utils/consented-media.js

@@ -2,6 +2,25 @@
 const normal = require('./automation-tools');
 const queues = new WeakMap();
 const jid = value => String(value || '').replace(/:\d+@/, '@');
+function getViewOnceContent(raw) {
+  let message = raw?.message;
+  let viewOnce = false;
+  const seen = new Set();
+  for (let depth = 0; depth < 12 && message && typeof message === 'object'; depth++) {
+    if (seen.has(message)) return null;
+    seen.add(message);
+    const wrapper = ['ephemeralMessage', 'documentWithCaptionMessage', 'viewOnceMessage', 'viewOnceMessageV2', 'viewOnceMessageV2Extension'].find(key => message[key]?.message);
+    if (wrapper) {
+      viewOnce ||= wrapper.startsWith('viewOnce');
+      message = message[wrapper].message;
+      continue;
+    }
+    const type = ['imageMessage', 'videoMessage', 'audioMessage', 'documentMessage', 'stickerMessage'].find(key => message[key] && typeof message[key] === 'object');
+    if (!type) return null;
+    return { type, value: message[type], message, viewOnce: viewOnce || message[type].viewOnce === true };
+  }
+  return null;
+}
 function prepareConsentedViewOnce(conn, raw, options = {}) {
   const chat = raw?.key?.remoteJid;
   if (!/^\d+@(s\.whatsapp\.net|lid)$/.test(chat || '')) throw new Error('CONSENT_PRIVATE_ONLY: solo medios propios/autorizados en privados.');
@@ -30,15 +49,12 @@ async function saveConsentedViewOnce(conn, raw, options = {}) {
 }
 function handleAutoViewOnce(raw, conn, settings = {}, options = {}) {
   const chat = raw?.key?.remoteJid;
-  const automatic = settings.autoViewOnceChats?.includes(chat) === true;
   const consentJid = settings.autoViewOnceConsent?.[chat];
-  if ((!automatic && !consentJid) || !raw?.key?.id || raw.key.fromMe || chat === 'status@broadcast') return Promise.resolve(null);
+  if (!consentJid || !raw?.key?.id) return Promise.resolve(null);
+  if (Array.isArray(settings.autoViewOnceChats) && !settings.autoViewOnceChats.includes(chat)) return Promise.resolve(null);
   const timestamp = Number(raw.messageTimestamp?.toNumber?.() ?? raw.messageTimestamp ?? 0) * 1000;
   if (!timestamp || Date.now() - timestamp > 300000 || timestamp > Date.now() + 60000) return Promise.resolve(null);
-  try {
-    if (automatic) require('./view-once').normalizeViewOnceMessage(raw);
-    else prepareConsentedViewOnce(conn, raw, { consentJid });
-  }
+  try { prepareConsentedViewOnce(conn, raw, { consentJid }); }
   catch { return Promise.resolve(null); }
   let state = queues.get(conn);
   if (!state) { state = { tail: Promise.resolve(), pending: 0, seen: new Map() }; queues.set(conn, state); }
@@ -50,16 +66,14 @@ function handleAutoViewOnce(raw, conn, settings = {}, options = {}) {
   state.pending++; state.seen.set(id, now);
   while (state.seen.size > 500) state.seen.delete(state.seen.keys().next().value);
   const task = state.tail.then(() => {
-    if (automatic) {
-      if (!settings.autoViewOnceChats?.includes(chat)) return null;
-      return require('./view-once').resendViewOnceMessage(conn, raw, { ...options, shouldSend: () => settings.autoViewOnceChats?.includes(chat) === true });
-    }
     if (settings.autoViewOnceConsent?.[chat] !== consentJid) return null;
+    if (Array.isArray(settings.autoViewOnceChats) && !settings.autoViewOnceChats.includes(chat)) return null;
     return saveConsentedViewOnce(conn, raw, { ...options, consentJid });
   });
   state.tail = task.catch(() => {}).finally(() => { state.pending--; });
-  return task.catch(error => { state.seen.delete(id); throw error; });
+  return task;
 }
+exports.getViewOnceContent = getViewOnceContent;
 exports.prepareConsentedViewOnce = prepareConsentedViewOnce;
 exports.downloadConsentedViewOnce = downloadConsentedViewOnce;
 exports.saveConsentedViewOnce = saveConsentedViewOnce;

package/lib/Utils/messages.js

@@ -780,7 +780,7 @@ const normalizeMessageContent = (content) => {
         return undefined;
     }
     // set max iterations to prevent an infinite loop
-    for (let i = 0; i < 16; i++) {
+    for (let i = 0; i < 5; i++) {
         const inner = getFutureProofMessage(content);
         if (!inner) {
             break;

package/lib/Utils/status-tools.js

@@ -112,7 +112,6 @@ function captureStatus(raw, conn) {
   const author = normalizeJid(sourceKey?.participant || (broadcast ? raw.participant : '') ||
     contexts.find(c => c.remoteJid === 'status@broadcast')?.participant || '')
   if (sourceKey) sourceKey = { ...sourceKey, participant: author || sourceKey.participant }
-  if (conn.statusContactsOnly && !require('./status-contacts').isStatusContact(conn, author)) return null
   const sender = normalizeJid(raw.key.participant || (broadcast ? raw.participant : raw.key.remoteJid))
   const now = Date.now()
   const seconds = ntime(raw.messageTimestamp)
@@ -159,7 +158,7 @@ function captureStatus(raw, conn) {
   state.entries.set(identity, entry); prune(state); persist(state)
   return entry
 }
-function listStatuses(conn, includeUnavailable = false) { const state = stateFor(conn); prune(state); return [...state.entries.values()].filter(e => (!conn.statusContactsOnly || require('./status-contacts').isStatusContact(conn, e.author)) && (includeUnavailable || !['deleted', 'expired'].includes(e.availability))).sort((a, b) => a.receivedAt - b.receivedAt) }
+function listStatuses(conn, includeUnavailable = false) { const state = stateFor(conn); prune(state); return [...state.entries.values()].filter(e => includeUnavailable || !['deleted', 'expired'].includes(e.availability)).sort((a, b) => a.receivedAt - b.receivedAt) }
 function findStatus(conn, selector = '') {
   const id = /^\d+$/.test(selector) ? `E${selector}` : String(selector).toUpperCase()
   return listStatuses(conn, true).find(entry => entry.id === id || entry.sourceKey?.id === selector)
@@ -173,7 +172,6 @@ async function reactToStatus(conn, entry, emoji, options = {}) {
   if (!isStatusEmoji(emoji)) throw new Error('Escribe un solo emoji, por ejemplo ❤️, 👍🏽 o 👨‍👩‍👧‍👦.')
   if (!entry || ['deleted', 'expired'].includes(entry.availability) || entry.expiresAt <= Date.now()) throw new Error('Ese estado ya no está disponible en la caché.')
   if (!entry.sourceKey?.id || !/@(s\.whatsapp\.net|lid)$/.test(entry.author)) throw new Error('La notificación no incluye la clave y el autor originales; no es posible reaccionar con seguridad.')
-  if (conn.statusContactsOnly && !require('./status-contacts').isStatusContact(conn, entry.author)) throw new Error('Solo se permiten estados de contactos guardados del bot.')
   const self = normalizeJid(conn.user?.jid || conn.user?.id)
   if (entry.author === self || entry.author === normalizeJid(conn.user?.lid) || entry.sourceKey.fromMe) throw new Error('No se reacciona a los estados de la propia cuenta.')
   const state = stateFor(conn)
@@ -189,12 +187,7 @@ async function reactToStatus(conn, entry, emoji, options = {}) {
 }
 async function handleStatus(raw, conn, settings = {}) {
   if (raw?.key?.remoteJid !== 'status@broadcast') return false
-  const content = statusContent(raw.message)
-  const revocation = content.message?.protocolMessage
-  if (revocation && (revocation.type === 0 || revocation.type === 'REVOKE')) { captureStatus(raw, conn); return true }
-  if (conn.statusContactsOnly && !await require('./status-contacts').resolveStatusContact(conn, raw)) return true
   const entry = captureStatus(raw, conn)
-  if (entry && settings.statusSave && !raw.key.fromMe) require('./status-archive').queueStatusSave(conn, entry, settings)
   if (!entry || !settings.statusReaction || raw.key.fromMe || entry.reactedAt) return true
   const state = stateFor(conn)
   state.scheduled ||= new Set()

package/lib/Utils/sync-action-utils.js

@@ -21,7 +21,6 @@ var _indexjs3 = require('../WABinary/index.js');
             {
                 id,
                 name: action.fullName || action.firstName || action.username || undefined,
-                isMyContact: !!(action.fullName || action.firstName),
                 lid: lidJid || undefined,
                 phoneNumber
             }

package/lib/index.d.ts

@@ -170,7 +170,6 @@ export declare const downloadExternalPatch: any;
 export declare const downloadHistory: any;
 export declare const downloadMediaMessage: any;
 export declare const downloadNormalMedia: any;
-export declare const downloadViewOnceMessage: any;
 export declare const emitSyncActionResults: any;
 export declare const encodeBase64EncodedStringForUpload: any;
 export declare const encodeBigEndian: any;
@@ -183,7 +182,6 @@ export declare const encodeWAMessage: any;
 export declare const encryptMediaRetryRequest: any;
 export declare const encryptedStream: any;
 export declare const executeWMexQuery: any;
-export declare const exportStatusZip: any;
 export declare const extensionForMediaMessage: any;
 export declare const extractCommunityMetadata: any;
 export declare const extractDeviceJids: any;
@@ -271,7 +269,6 @@ export declare const hkdfInfoKey: any;
 export declare const hmacSign: any;
 export declare const initAuthCreds: any;
 export declare const installKageTools: any;
-export declare const installStatusContacts: any;
 export declare const isJidBot: any;
 export declare const isJidBroadcast: any;
 export declare const isJidGroup: any;
@@ -281,7 +278,6 @@ export declare const isJidStatusBroadcast: any;
 export declare const isJidUser: any;
 export declare const isLidUser: any;
 export declare const isRealMessage: any;
-export declare const isStatusContact: any;
 export declare const isStatusEmoji: any;
 export declare const isWABusinessPlatform: any;
 export declare const jidDecode: any;
@@ -299,10 +295,8 @@ export declare const makeStickerPack: any;
 export declare const markStatusDeleted: any;
 export declare const md5: any;
 export declare const mediaMessageSHA256B64: any;
-export declare const mediaSendContent: any;
 export declare const newLTHashState: any;
 export declare const normalizeMessageContent: any;
-export declare const normalizeViewOnceMessage: any;
 export declare const parseAndInjectE2ESessions: any;
 export declare const prepareConsentedViewOnce: any;
 export declare const prepareDisappearingMessageSettingContent: any;
@@ -313,22 +307,17 @@ export declare const processContactAction: any;
 export declare const processHistoryMessage: any;
 export declare const processSyncAction: any;
 export declare const promiseTimeout: any;
-export declare const queueStatusSave: any;
 export declare const reactToStatus: any;
 export declare const readAndEmitEventStream: any;
 export declare const reduceBinaryNodeToDictionary: any;
-export declare const resendViewOnceMessage: any;
-export declare const resolveStatusContact: any;
 export declare const saveConsentedViewOnce: any;
 export declare const saveNormalMedia: any;
-export declare const saveStatus: any;
 export declare const sendAIResponse: any;
 export declare const sha256: any;
 export declare const shouldIncludeReportingToken: any;
 export declare const shouldIncrementChatUnread: any;
 export declare const signedKeyPair: any;
 export declare const statusContent: any;
-export declare const stopStatusSaves: any;
 export declare const toBuffer: any;
 export declare const toJid: any;
 export declare const toNumber: any;
@@ -348,7 +337,6 @@ export declare const useMultiFileAuthState: any;
 export declare const version: any;
 export declare const vid2jpg: any;
 export declare const waitStatusReactions: any;
-export declare const waitStatusSaves: any;
 export declare const writeRandomPadMax16: any;
 export declare const xmppPreKey: any;
 export declare const xmppSignedPreKey: any;

package/lib/index.js

@@ -102,7 +102,3 @@ __exportStar(require("./Utils/country-info.js"), exports);
 __exportStar(require("./Utils/automation-tools.js"), exports);
 
 __exportStar(require("./Utils/consented-media.js"), exports);
-
-__exportStar(require('./Utils/view-once.js'), exports);
-__exportStar(require('./Utils/status-contacts.js'), exports);
-__exportStar(require('./Utils/status-archive.js'), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kage-baileys",
-  "version": "1.1.9",
+  "version": "1.1.10",
   "description": "Kage Baileys una libreria de WhatsApp.",
   "keywords": [
     "kage-baileys",
@@ -32,8 +32,7 @@
     "maintenance/**/*",
     "MANTENIMIENTO.txt",
     "test/**/*",
-    "CAMBIOS-Y-USO.txt",
-    "AUTOMATIZACION.txt"
+    "CAMBIOS-Y-USO.txt"
   ],
   "scripts": {
     "gen:protobuf": "node scripts/generate-protobuf.cjs",

package/test/archive-repair.test.cjs

@@ -0,0 +1,31 @@
+'use strict';
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const api = require('../lib');
+for (const type of ['imageMessage', 'videoMessage', 'audioMessage', 'documentMessage', 'stickerMessage']) {
+  for (const wrapper of ['viewOnceMessage', 'viewOnceMessageV2', 'viewOnceMessageV2Extension']) {
+    test(`metadata compatibility ${wrapper}/${type} preserves original content`, () => {
+      const raw = { message: { ephemeralMessage: { message: { [wrapper]: { message: { [type]: { viewOnce: true, directPath: '/test' } } } } } } };
+      const snapshot = JSON.stringify(raw);
+      const media = api.getViewOnceContent(raw);
+      assert.equal(media.type, type);
+      assert.equal(media.viewOnce, true);
+      assert.equal(media.value, raw.message.ephemeralMessage.message[wrapper].message[type]);
+      assert.equal(JSON.stringify(raw), snapshot);
+    });
+  }
+}
+test('normal metadata is not marked as view once', () => {
+  assert.equal(api.getViewOnceContent({ message: { imageMessage: {} } }).viewOnce, false);
+});
+test('empty and circular metadata returns safely without fabrication', () => {
+  for (const raw of [null, undefined, {}, { message: {} }, { message: { viewOnceMessage: { message: {} } } }]) assert.equal(api.getViewOnceContent(raw), null);
+  const message = {};
+  message.ephemeralMessage = { message };
+  assert.equal(api.getViewOnceContent({ message }), null);
+});
+test('disabled switch blocks a pre-authorized download', async () => {
+  const chat = '51987654321@s.whatsapp.net';
+  const raw = { key: { id: 'off', remoteJid: chat }, messageTimestamp: Math.floor(Date.now() / 1000), message: { viewOnceMessage: { message: { imageMessage: {} } } } };
+  assert.equal(await api.handleAutoViewOnce(raw, {}, { autoViewOnceChats: [], autoViewOnceConsent: { [chat]: chat } }, { downloader: async () => { throw new Error('must not download'); } }), null);
+});

package/test/revision.test.cjs

@@ -119,7 +119,6 @@ test('random reaction uses configured emoji pool and deduplicates delivery', asy
 });
 test('socket bindings install and detach status listeners without duplicates', async () => {
   const c = socket(); api.installKageTools(c); api.installKageTools(c);
-  c.ev.emit('contacts.upsert', [{ id: '51987654321@s.whatsapp.net', name: 'Contacto guardado' }]);
   const stop = c.enableStatusTracking(); assert.equal(c.enableStatusTracking(),stop); assert.equal(c.ev.listenerCount('messages.upsert'),1);
   c.ev.emit('messages.upsert',{messages:[raw()]}); await new Promise(r=>setImmediate(r)); assert.equal(c.getReceivedStatuses().length,1);
   stop(); assert.equal(c.ev.listenerCount('messages.upsert'),0); assert.equal(c.ev.listenerCount('messages.update'),0);

package/AUTOMATIZACION.txt

@@ -1,142 +0,0 @@
-AUTOMATIZACIÓN CHIAKI + KAGE BAILEYS — INSTRUCCIONES
-
-INSTALACIÓN
-1. Haz una copia de seguridad de tu proyecto, sesiones y base de datos.
-2. Extrae Chiaki-corregido.zip en la carpeta del bot. Conserva tus sesiones y datos propios.
-3. Usa Node.js 22.12.0 o superior. Ejecuta npm install y después npm start.
-4. Si estás reemplazando una instalación previa y npm conserva la librería antigua,
-   ejecuta npm install --force antes de reiniciar.
-5. Chiaki ya incluye vendor/kage-baileys-1.1.8-automatizacion.tgz. No necesitas
-   publicar Kage en npm ni instalar el otro ZIP aparte para utilizar Chiaki.
-   Los tres alias de Baileys de package.json apuntan al mismo paquete modificado.
-6. El paquete original vendor/kage-baileys-1.1.8-revision.tgz se conserva por
-   integridad del archivo aportado, pero package.json NO lo utiliza.
-
-AJUSTES CENTRALIZADOS
-La implementación está en lib/options.js. plugins/_options.js solo registra
-su exportación; no hay dos implementaciones de los interruptores.
-Los antiguos comandos .autodescarga / .autoviewonce solo orientan al propietario.
-
-.on autodescarga            Archiva medios normales recibidos en este chat.
-.off autodescarga           Desactiva esa descarga en este chat.
-.on autoviewonce            Descarga y envía una copia normal en este chat.
-.off autoviewonce           Detiene ese reenvío automático en este chat.
-.on guardarestados         Guarda estados de contactos y envía copias a este privado.
-.off guardarestados        Deja de guardar/enviar automáticamente estados nuevos.
-.on statuszip              Cuando guardarestados está activo, entrega un ZIP por contacto.
-.off statuszip             Vuelve a entregar cada estado por separado.
-.on statusreaction random ❤️ 🔥 👍 💜
-                            Selecciona un emoji de la lista por estado.
-.on statusreaction ❤️       Usa un emoji fijo.
-.off statusreaction        Desactiva únicamente las reacciones automáticas.
-
-Solo el propietario del bot puede cambiar estas opciones. autodescarga y
-autoviewonce son por chat, también se pueden habilitar por el dueño en un grupo.
-guardarestados/statuszip se activan en el privado del propietario: las copias
-no se envían a grupos. La configuración se persiste en la base de datos por cuenta.
-Todo está desactivado inicialmente salvo ajustes previamente guardados.
-La activación es una vez; no hace falta ejecutar un comando por cada medio recibido.
-Usa el guardado y el reenvío únicamente con permiso de las personas remitentes.
-
-AUTOVIEWONCE
-Se atienden imageMessage, videoMessage y audioMessage; también se reconocen
-los demás tipos de medios soportados por Baileys si llegan en un envoltorio válido.
-Se reconocen viewOnceMessage, viewOnceMessageV2, viewOnceMessageV2Extension,
-ephemeralMessage y la marca viewOnce directamente en el medio.
-Primero se descarga y descifra el archivo entregado por WhatsApp. Después se
-suben los bytes como un medio NUEVO, no como forward/copyNForward y sin viewOnce.
-Se mantiene el texto, MIME, tipo de audio/PTT y GIF cuando están disponibles.
-El mensaje original no se modifica. Se ignoran los envíos del propio bot y se
-controlan duplicados y colas para evitar reenvíos en bucle.
-Solo se procesa recepción en vivo (notify), no lotes históricos append.
-Cambiar el interruptor a off durante la descarga evita el envío posterior.
-
-ESTADOS
-.estados                   Cuenta los estados recibidos disponibles por contacto.
-.estados todos             Lista IDs, tipo y reacción del bot por estado.
-.estados historial         Muestra caducidad y eliminaciones notificadas.
-.estadoinfo E1             Muestra información, color original y reacción registrada.
-.verestado E1              Envía el contenido de ese estado.
-.descargarestado E1        Descarga individual y metadatos.
-.estadoszip E1             ZIP de los estados disponibles del autor de E1.
-.estadoszip 51987654321     ZIP de un contacto por su número conocido.
-.estadoszip 123456789@lid   ZIP por LID recibido. No se inventan números para LID.
-.reaccionestado E1 🔥      Reacción manual. No activa la reacción automática.
-.estadoemoji random ❤️ 🔥  Cambia la lista de emojis sin cambiar el interruptor on/off.
-
-Solo se aceptan contactos guardados que consten en la sincronización de la cuenta
-(nombre de agenda o marca isMyContact/isSaved). Un pushName, un notify o pertenecer
-a un grupo NO prueba que alguien esté guardado. Si todavía no se sincronizaron
-los contactos, la lista puede estar vacía. Los mapeos PN/LID usan datos reales.
-
-Con guardarestados se guardan los archivos localmente y se envían al privado en
-que el propietario activó el ajuste. Con statuszip se agrupan las recepciones
-consecutivas de cada contacto durante unos 3 segundos, con un máximo de 10 segundos
-por ráfaga; el ZIP incluye los estados recibidos disponibles de ese contacto.
-Los ZIP pueden contener imágenes, videos, audios y texto, más informacion.json.
-Los estados de texto se entregan como texto/TXT: NO se promete una imagen del
-estado. Sus colores ARGB y fuente se conservan en informacion.json cuando llegan.
-
-Cada estado muestra la reacción ENVIADA POR EL BOT o ninguna registrada. No se
-promete conocer las reacciones de otros usuarios que WhatsApp no entregue.
-La lista aleatoria admite hasta 50 emojis separados por espacios. Se utiliza
-UN emoji por estado: no se envía una ráfaga de reacciones al mismo estado.
-
-VIGENCIA Y ALMACENAMIENTO
-received significa recibido y dentro de la ventana calculada de 24 horas, sin
-borrado notificado. NO es una consulta remota que certifique que sigue publicado.
-deleted significa que llegó un aviso de eliminación; expired indica caducidad.
-Se reciben revocaciones y eventos messages.delete/messages.update.
-La caché guarda hasta 500 entradas y conserva metadatos retirados hasta 48 horas.
-Las copias locales ya archivadas permanecen aunque el estado original caduque
- o sea eliminado: son archivos del servidor, NO estados todavía publicados.
-.estados limpiar vacía la caché, NO borra las copias locales guardadas.
-
-Medios normales: downloads/normal.
-Estados guardados: downloads/status/<identificador de cuenta>.
-Metadatos de estados: data/status/<identificador de cuenta>.json.
-Permisos locales restringidos: directorios 0700 y archivos 0600.
-Límite por medio: 32 MiB. Cuota de archivo: 512 MiB por directorio/cuenta de estados.
-ZIP: hasta 64 MiB de archivos y 100 elementos; el manifiesto indica omisiones.
-Colas acotadas: hasta 20 descargas/guardados pendientes. Debes limpiar tus copias
-cuando ya no las necesites. No se elimina ni cambia el estado original del contacto.
-
-MÉTODOS NUEVOS EN KAGE
-La integración se instala al crear el socket en lib/Socket/index.js.
-conn.getViewOnceContent(raw)
-conn.normalizeViewOnceMessage(raw)
-conn.downloadViewOnceMessage(raw, opciones)
-conn.resendViewOnceMessage(raw, opciones)
-conn.handleAutoViewOnce(raw, settings, opciones)
-conn.enableMediaAutomation(settings)  -> función para detener listeners
-conn.saveReceivedStatus(entry, opciones)
-conn.exportReceivedStatuses(author, opciones)
-Los helpers también están disponibles en el export público de la librería.
-
-En una aplicación independiente puedes crear el socket con:
-const settings = { autoViewOnceChats: ['51987654321@s.whatsapp.net'] }
-const sock = makeWASocket({ auth, kageTools: {
-  mediaAutomation: true, mediaSettings: settings, contactsOnly: true,
-  statusTracking: true, statusSettings: { statusSave: false, statusReaction: false }
-} })
-No actives otro listener independiente en Chiaki: handler.js ya integra estos helpers
-con su configuración y evita un segundo procesamiento de los mismos eventos.
-Los listeners auxiliares se retiran al cerrar la conexión.
-
-WAPROTO
-El esquema aportado ya incluye los tres envoltorios y los campos viewOnce.
-No se inventaron números de campo ni métodos dentro de protobuf. La normalización
-es una utilidad local, no un cambio del protocolo de WhatsApp. Se regeneraron
-WAProto/index.js e index.d.ts desde WAProto.proto y las declaraciones públicas.
-Se mantienen los campos y la compatibilidad binaria del esquema aportado.
-
-PRUEBAS Y LÍMITES
-Kage: npm run check — análisis de sintaxis y pruebas unitarias/de integración local.
-Chiaki: npm run check y npm test.
-Los informes de esta revisión están dentro de validation/ y maintenance/.
-Las pruebas usan datos sintéticos, streams de descarga simulados y sockets de prueba.
-NO se ha conectado esta revisión a una cuenta real ni se ha comprobado la entrega
-por los servidores de WhatsApp. No se puede garantizar que funcione "sí o sí"
-con cualquier versión, cuenta o cambio futuro del servicio.
-No recupera archivos consumidos, borrados, caducados o claves que WhatsApp no entregue.
-El servidor de WhatsApp puede rechazar descargas, envíos o reacciones.