app-manager-edge-worker 1.0.0 → 1.0.1

package/README.md

@@ -17,6 +17,7 @@ Cloud datacenter IPs (Render, AWS, DigitalOcean, Hetzner) are frequently blocked
 - 🔒 **Zero Port Forwarding**: Persistent outbound WebSockets (`wss://.../workers`) effortlessly traverse home Wi-Fi routers, firewalls, and carrier-grade NAT (CGNAT).
 - ⚡ **Autonomous Chromium Engine**: Checks your system for Chrome/Edge or automatically installs stable Chromium without any manual intervention.
 - 📱 **Android Phone Support**: Transform an old spare Android phone into a 24/7 scraping powerhouse using Termux and Wake Lock.
+- ⏰ **Automated Render Anti-Sleep Keep-Alive**: Periodically pings the central server (every 7 minutes by default) to keep Render free-tier instances warm and eliminate cold-start spindowns.
 - 🚀 **Smart Single-Flight Deduplication**: Concurrent scrapes for the exact same target URL coalesce into a single execution flight.
 
 ---
@@ -142,6 +143,8 @@ No manual setup required!
 | `-s, --server <url>` | Apps Manager Server URL | `https://apps-manager.onrender.com` |
 | `-c, --concurrency <n>` | Max concurrent Chromium browser tabs | `3` |
 | `-n, --name <name>` | Custom display name for this worker | Device hostname |
+| `-p, --keep-alive <minutes>` | Keep-alive ping interval to prevent Render free-tier cold sleep | `7` |
+| `--no-keep-alive` | Disable keep-alive ping loop | - |
 | `--reset` | Clear stored credentials and prompt again | - |
 | `-h, --help` | Display help screen | - |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "app-manager-edge-worker",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "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

@@ -11,7 +11,7 @@ const colors = {
     gray: "\x1b[90m",
 };
 
-export function printBanner({ workerName, serverUrl, concurrency, platform, isTermux }) {
+export function printBanner({ workerName, serverUrl, concurrency, platform, isTermux, keepAliveMinutes }) {
     console.clear();
     console.log(`${colors.cyan}${colors.bright}`);
     console.log("   █████╗ ██████╗ ██████╗ ███████╗   ███╗   ███╗ █████╗ ███╗   ██╗ █████╗  ██████╗ ███████╗██████╗ ");
@@ -21,13 +21,14 @@ export function printBanner({ workerName, serverUrl, concurrency, platform, isTe
     console.log("  ██║  ██║██║     ██║     ███████║██╗██║ ╚═╝ ██║██║  ██║██║ ╚████║██║  ██║╚██████╔╝███████╗██║  ██║");
     console.log("  ╚═╝  ╚═╝╚═╝     ╚═╝     ╚══════╝╚═╝╚═╝     ╚═╝╚═╝  ╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═╝");
     console.log(`${colors.reset}`);
-    console.log(`${colors.bright}  🌐 Distributed Scraper Edge Worker Client v1.0.0${colors.reset}`);
+    console.log(`${colors.bright}  🌐 Distributed Scraper Edge Worker Client v1.0.1${colors.reset}`);
     console.log(`${colors.dim}  Zero-cost, persistent tunneling & residential edge scraping${colors.reset}`);
     console.log("--------------------------------------------------------------------------------");
     console.log(`  ${colors.bright}Device Name  :${colors.reset} ${colors.green}${workerName}${colors.reset}`);
     console.log(`  ${colors.bright}Server URL   :${colors.reset} ${colors.cyan}${serverUrl}${colors.reset}`);
     console.log(`  ${colors.bright}Concurrency  :${colors.reset} ${colors.yellow}${concurrency} concurrent tabs${colors.reset}`);
     console.log(`  ${colors.bright}Environment  :${colors.reset} ${platform} ${isTermux ? "(Termux Android)" : ""}`);
+    console.log(`  ${colors.bright}Keep-Alive   :${colors.reset} ${keepAliveMinutes > 0 ? `${colors.green}Every ${keepAliveMinutes}m (Render Anti-Sleep Active)${colors.reset}` : `${colors.gray}Disabled${colors.reset}`}`);
     console.log("--------------------------------------------------------------------------------\n");
 }
 

package/src/client.js

@@ -1,13 +1,14 @@
 import { io } from "socket.io-client";
 import os from "os";
 import path from "path";
+import axios from "axios";
 import localBrowserManager from "./browser.js";
 import { handleChromiumScrape, handleHttpScrape } from "./handlers/scrapeHandler.js";
 import { handlePreviewPage, handleInspectElement } from "./handlers/previewHandler.js";
 import { printBanner, logInfo, logSuccess, logWarn, logError, logJob } from "./banner.js";
 
 export async function startWorkerClient(config) {
-    const { workerKey, serverUrl, concurrency, workerName } = config;
+    const { workerKey, serverUrl, concurrency, workerName, keepAliveMinutes = 7 } = config;
     const isTermux = localBrowserManager.isTermux();
 
     printBanner({
@@ -16,6 +17,7 @@ export async function startWorkerClient(config) {
         concurrency,
         platform: `${os.platform()} ${os.arch()}`,
         isTermux,
+        keepAliveMinutes,
     });
 
     logInfo("Checking Chromium browser availability...");
@@ -133,8 +135,53 @@ export async function startWorkerClient(config) {
         });
     });
 
+    // Render Anti-Sleep Keep-Alive Ping
+    let keepAliveTimer = null;
+    let initialKeepAliveTimer = null;
+
+    if (keepAliveMinutes > 0) {
+        const pingKeepAlive = async () => {
+            try {
+                // Try the dedicated keep-alive endpoint first
+                const endpoint = `${serverUrl}/api/workers/keep-alive`;
+                const res = await axios.get(endpoint, {
+                    timeout: 15000,
+                    headers: {
+                        "x-worker-key": workerKey || "",
+                        "user-agent": "AppsManagerEdgeWorker/1.0.1",
+                    },
+                });
+                logInfo(`[Keep-Alive] Server awake ping OK (${res.status}) - Render instance active`);
+            } catch (err) {
+                // Fallback to /health
+                try {
+                    const fallbackUrl = `${serverUrl}/health`;
+                    await axios.get(fallbackUrl, {
+                        timeout: 10000,
+                        headers: {
+                            "user-agent": "AppsManagerEdgeWorker/1.0.1",
+                        },
+                    });
+                    logInfo(`[Keep-Alive] Fallback health ping OK - Render instance active`);
+                } catch (fallbackErr) {
+                    logWarn(`[Keep-Alive] Server awake ping warning (${err.message}) - will retry next cycle`);
+                }
+            }
+        };
+
+        // Send initial ping 15s after startup to warm up/verify
+        initialKeepAliveTimer = setTimeout(pingKeepAlive, 15000);
+        if (initialKeepAliveTimer.unref) initialKeepAliveTimer.unref();
+
+        const intervalMs = Math.max(1, keepAliveMinutes) * 60 * 1000;
+        keepAliveTimer = setInterval(pingKeepAlive, intervalMs);
+        if (keepAliveTimer.unref) keepAliveTimer.unref();
+    }
+
     // Graceful shutdown handling
     const shutdown = async () => {
+        if (keepAliveTimer) clearInterval(keepAliveTimer);
+        if (initialKeepAliveTimer) clearTimeout(initialKeepAliveTimer);
         logInfo("\nGracefully shutting down edge worker...");
         socket.disconnect();
         await localBrowserManager.close();

package/src/config.js

@@ -65,6 +65,10 @@ export function parseCliArgs() {
             parsed.concurrency = parseInt(args[++i], 10);
         } else if (arg === "--name" || arg === "-n") {
             parsed.name = args[++i];
+        } else if (arg === "--keep-alive" || arg === "-p") {
+            parsed.keepAlive = parseInt(args[++i], 10);
+        } else if (arg === "--no-keep-alive") {
+            parsed.keepAlive = false;
         } else if (arg === "--reset") {
             parsed.reset = true;
         } else if (arg === "--help" || arg === "-h") {
@@ -102,7 +106,7 @@ export async function resolveWorkerConfig() {
 
     if (cli.help) {
         console.log(`
-Apps Manager Scraper Edge Worker CLI
+Apps Manager Scraper Edge Worker CLI v1.0.1
 
 Usage:
   npx app-manager-edge-worker [options]
@@ -112,6 +116,8 @@ Options:
   -s, --server <url>          Apps Manager Server URL (e.g. https://apps-manager.onrender.com)
   -c, --concurrency <number>  Maximum concurrent browser tabs (default: 3)
   -n, --name <name>           Custom display name for this worker device
+  -p, --keep-alive <minutes>  Interval in minutes to ping server and prevent Render free-tier sleep (default: 7)
+      --no-keep-alive         Disable keep-alive ping
       --reset                 Clear stored credentials and prompt again
   -h, --help                  Display this help message
         `);
@@ -192,10 +198,21 @@ Options:
     // Clean up trailing slash
     serverUrl = serverUrl.replace(/\/+$/, "");
 
+    // Keep-alive ping interval (default 7 minutes, 0 to disable)
+    let keepAliveMinutes = 7;
+    if (cli.keepAlive === false || process.env.KEEP_ALIVE === "false") {
+        keepAliveMinutes = 0;
+    } else if (typeof cli.keepAlive === "number" && !isNaN(cli.keepAlive)) {
+        keepAliveMinutes = Math.max(0, cli.keepAlive);
+    } else if (process.env.KEEP_ALIVE_MINUTES) {
+        keepAliveMinutes = parseInt(process.env.KEEP_ALIVE_MINUTES, 10) || 7;
+    }
+
     return {
         workerKey: workerKey.trim(),
         serverUrl,
         concurrency,
         workerName,
+        keepAliveMinutes,
     };
 }