kage-baileys 1.1.7 → 1.1.9

package/AUTOMATIZACION.txt

@@ -0,0 +1,142 @@
+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.

package/WAProto/WAProto.proto

@@ -2290,6 +2290,8 @@ 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;