app-manager-edge-worker 1.1.4 → 1.1.5

package/README.md

@@ -203,6 +203,12 @@ Log levels: `[INFO]` · `[SUCCESS]` · `[WARN]` · `[ERROR]` · `[TASK]` (job di
 
 ## 📝 Changelog
 
+### v1.1.5
+- **Real-Time WhatsApp Task & Document Streaming Telemetry**:
+  - Added timestamped terminal logging for incoming WhatsApp text and document task receipts.
+  - Live progress logs for authenticated PDF document streaming, byte transfer size, and SHA-256 integrity validation.
+  - Real-time typing presence simulation status and delivery confirmations with official message IDs (`wamid`).
+
 ### v1.1.4
 - **Persistent MongoDB Session Restoration for WhatsApp**:
   - Automatically restores WhatsApp companion device credentials (`creds.json`, pre-keys, session keys) from cluster MongoDB on worker boot.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "app-manager-edge-worker",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "description": "Distributed Scraper Edge Worker for Apps Manager. Run on any local machine, VPS, or Termux Android device to serve browser and HTTP scraping jobs.",
   "type": "module",
   "bin": {

package/src/banner.js

@@ -1,7 +1,7 @@
 import { createRequire } from "module";
 
 const require = createRequire(import.meta.url);
-let workerVersion = "1.1.0";
+let workerVersion = "1.1.5";
 try {
     const pkg = require("../package.json");
     if (pkg?.version) workerVersion = pkg.version;

package/src/client.js

@@ -12,7 +12,7 @@ import fs from "fs";
 import { getWhatsAppHandler } from "./handlers/whatsappHandler.js";
 import { printBanner, logInfo, logSuccess, logWarn, logError, logJob } from "./banner.js";
 
-let workerPkgVersion = "1.1.4";
+let workerPkgVersion = "1.1.5";
 try {
     const pkg = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
     if (pkg?.version) workerPkgVersion = pkg.version;

package/src/config.js

@@ -111,7 +111,7 @@ export async function resolveWorkerConfig() {
     const cli = parseCliArgs();
 
     if (cli.help) {
-        let pkgVer = "1.1.0";
+        let pkgVer = "1.1.5";
         try {
             const pkg = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
             if (pkg?.version) pkgVer = pkg.version;

package/src/handlers/whatsappHandler.js

@@ -11,6 +11,7 @@ import path from "path";
 import os from "os";
 import crypto from "crypto";
 import axios from "axios";
+import { logInfo, logSuccess, logWarn } from "../banner.js";
 
 /**
  * WhatsApp Companion Device Engine for App Manager Edge Worker.
@@ -463,6 +464,7 @@ export class WhatsAppWorkerHandler {
      * Sends a plain text WhatsApp message with typing simulation and jitter.
      */
     async sendMessage({ recipientPhone, message, idempotencyKey = null }) {
+        logInfo(`[WhatsApp] Incoming message dispatch for ${recipientPhone}`);
         await this.initialize(false);
         if (!this.sock || this.status !== "CONNECTED") {
             throw new Error("WhatsApp companion device is not connected. Please pair via Admin Panel.");
@@ -474,6 +476,7 @@ export class WhatsAppWorkerHandler {
         if (idempotencyKey) {
             const alreadyDelivered = await this.reconcileDelivery(recipientPhone, idempotencyKey);
             if (alreadyDelivered) {
+                logInfo(`[WhatsApp] Reconciled delivery for ${recipientPhone}; duplicate aborted.`);
                 return {
                     success: true,
                     reconciled: true,
@@ -492,6 +495,7 @@ export class WhatsAppWorkerHandler {
         const targetJid = verified.jid || jid;
 
         // 3. Human Typing Simulation
+        logInfo(`[WhatsApp] Simulating human typing for ${digits}...`);
         await this.sock.sendPresenceUpdate("composing", targetJid).catch(() => {});
         const typingDurationMs = Math.min(Math.max((message.length || 20) * 35, 2000), 4500);
         await new Promise((r) => setTimeout(r, typingDurationMs));
@@ -507,10 +511,12 @@ export class WhatsAppWorkerHandler {
         // 5. Dispatch
         const result = await this.sock.sendMessage(targetJid, { text: finalMessage });
         this._resetIdleTimer();
+        const msgId = result?.key?.id || `wamid-${Date.now()}`;
+        logSuccess(`[WhatsApp] Text message successfully delivered to ${recipientPhone} (ID: ${msgId})`);
 
         return {
             success: true,
-            messageId: result?.key?.id || `wamid-${Date.now()}`,
+            messageId: msgId,
             timestamp: Date.now(),
         };
     }
@@ -528,6 +534,7 @@ export class WhatsAppWorkerHandler {
         caption = "",
         idempotencyKey = null,
     }) {
+        logInfo(`[WhatsApp] Incoming document task for ${recipientPhone} (${fileName})`);
         await this.initialize(false);
         if (!this.sock || this.status !== "CONNECTED") {
             throw new Error("WhatsApp companion device is not connected. Please pair via Admin Panel.");
@@ -539,6 +546,7 @@ export class WhatsAppWorkerHandler {
         if (idempotencyKey) {
             const alreadyDelivered = await this.reconcileDelivery(recipientPhone, idempotencyKey);
             if (alreadyDelivered) {
+                logInfo(`[WhatsApp] Reconciled delivery for ${recipientPhone}; duplicate aborted.`);
                 return {
                     success: true,
                     reconciled: true,
@@ -557,6 +565,7 @@ export class WhatsAppWorkerHandler {
         const targetJid = verified.jid || jid;
 
         // 3. Stream PDF from authenticated URL (Zero buffer in central WebSocket)
+        logInfo(`[WhatsApp] Streaming document attachment (${fileName})...`);
         const response = await axios.get(downloadUrl, {
             responseType: "arraybuffer",
             timeout: 25000,
@@ -581,8 +590,10 @@ export class WhatsAppWorkerHandler {
                 );
             }
         }
+        logInfo(`[WhatsApp] Document received (${(buffer.length / 1024).toFixed(1)} KB), SHA-256 integrity verified (${actualSha256.substring(0, 12)}...)`);
 
         // 5. Human Typing Simulation
+        logInfo(`[WhatsApp] Simulating human typing for ${digits}...`);
         await this.sock.sendPresenceUpdate("composing", targetJid).catch(() => {});
         await new Promise((r) => setTimeout(r, 2500));
         await this.sock.sendPresenceUpdate("paused", targetJid).catch(() => {});
@@ -603,10 +614,12 @@ export class WhatsAppWorkerHandler {
         });
 
         this._resetIdleTimer();
+        const msgId = result?.key?.id || `wamid-${Date.now()}`;
+        logSuccess(`[WhatsApp] Document successfully delivered to ${recipientPhone} (ID: ${msgId})`);
 
         return {
             success: true,
-            messageId: result?.key?.id || `wamid-${Date.now()}`,
+            messageId: msgId,
             timestamp: Date.now(),
         };
     }