arn-browser 0.1.4 → 0.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "arn-browser",
-	"version": "0.1.4",
+	"version": "0.1.6",
 	"description": "A lightweight, browser autmation helper.",
 	"main": "src/index.js",
 	"types": "src/index.d.ts",
@@ -14,7 +14,7 @@
 		"@aws-sdk/client-ec2": "^3.953.0",
 		"@ghostery/adblocker": "^2.13.0",
 		"arn-knexjs": "^0.0.3",
-		"camoufox-js": "^0.8.4",
+		"camoufox-js": "^0.9.1",
 		"dotenv": "^17.2.3",
 		"fingerprint-generator": "^2.1.78",
 		"fingerprint-injector": "^2.1.78",

package/src/utility/deleteDirectory.js

@@ -31,15 +31,14 @@ export async function deleteDirectoryWithRetries(targetPath, maxRetries = 5, ret
 
 			// If it's the last attempt, log error
 			if (isLastAttempt) {
-				console.error(`❌ Failed to delete directory after ${maxRetries} attempts: ${targetPath}`);
+				console.error(`░░░░░ Failed to delete directory after ${maxRetries} attempts: ${targetPath}`);
 				console.error(`   Error: ${error.message}`);
 				return false;
 			}
 
 			// Log warning and wait
 			console.warn(
-				`⚠️  Delete failed (Attempt ${attempt + 1}/${maxRetries}). File might be locked. Retrying in ${
-					retryDelayMs / 1000
+				`░░░░░  Delete failed (Attempt ${attempt + 1}/${maxRetries}). File might be locked. Retrying in ${retryDelayMs / 1000
 				}s...`
 			);
 			await sleep(retryDelayMs);

package/src/utility/launchBrowser.d.ts

@@ -152,14 +152,21 @@ export interface LaunchOptions {
 	/**
 	 * Path to a persistent profile.
 	 * - If absolute path: Uses that path exactly (no prefix added).
-	 * - If folder name: Creates inside `.data/browser_profiles/persistent/` AND adds a browser prefix (e.g., `brave_myProfile`).
-	 * - If null: Creates a temporary, random profile in `.data/browser_profiles/temp/`.
+	 * - If folder name: Creates inside `~/.arn-browser/persistent/` AND adds a browser prefix (e.g., `brave_myProfile`).
+	 * - If null: Creates a temporary, random profile in `~/.arn-browser/temp/`.
 	 */
 	profile_path?: string | null;
 
 	/**
-	 * If set to > 10, deletes temporary profiles older than X minutes.
-	 * Default: 0 (disabled)
+	 * Auto-cleanup profiles after X minutes since last launch.
+	 *
+	 * **Persistent profiles:** Cleaned after X minutes since last launch. Default: 0 (never clean).
+	 * **Temp profiles:** Default: 15 minutes if not specified.
+	 *
+	 * Each profile stores a `_profile_meta.json` with `created_at`, `last_launched_at`,
+	 * and `cleanup_minutes`. The profile currently being launched is always skipped during cleanup.
+	 *
+	 * Default: 0
 	 */
 	cleanupMinutes?: number;
 
@@ -222,6 +229,22 @@ export interface LaunchOptions {
 	 * Camoufox uses its own humanize option in camoufox_options.
 	 */
 	humanize_options?: HumanizeOptions;
+
+	// ========================================================================
+	// 6. LOGGING
+	// ========================================================================
+
+	/**
+	 * Enable launch-related console logs (browser start, fingerprint, tab cleanup, close).
+	 * Default: false
+	 */
+	launch_logs?: boolean;
+
+	/**
+	 * Enable cleanup-related console logs (expired profile deletion).
+	 * Default: false
+	 */
+	cleanup_logs?: boolean;
 }
 
 /**

package/src/utility/launchBrowser.js

@@ -40,14 +40,17 @@ const detectedOs = osMap[process.platform] || "windows";
 const MULTILOGIN_LAUNCHER_URL = "https://launcher.mlx.yt:45001";
 const MULTILOGIN_FOLDER_ID = "bad9e7e1-cfab-4c8d-bd19-91aa82929711";
 
-const PROJECT_ROOT = process.cwd();
-const BASE_PROFILE_DIR = path.join(PROJECT_ROOT, ".data", "browser_profiles");
+const BASE_PROFILE_DIR = path.join(os.homedir(), ".arn-browser");
 const PERSISTENT_DIR = path.join(BASE_PROFILE_DIR, "persistent");
 const TEMP_DIR = path.join(BASE_PROFILE_DIR, "temp");
 
 if (!fs.existsSync(PERSISTENT_DIR)) fs.mkdirSync(PERSISTENT_DIR, { recursive: true });
 if (!fs.existsSync(TEMP_DIR)) fs.mkdirSync(TEMP_DIR, { recursive: true });
 
+// Module-level log flags (set per-launch via launchBrowser options)
+let _launchLogs = false;
+let _cleanupLogs = false;
+
 // ==========================================================================
 // 2. HELPER FUNCTIONS
 // ==========================================================================
@@ -101,7 +104,7 @@ function getBinaryPath(browserName) {
 
 	if (!binaryPath || !fs.existsSync(binaryPath)) {
 		throw new Error(
-			`❌ [LaunchBrowser] Binary not found for ${browserName} at: ${binaryPath}\n` +
+			`░░░░░ [LaunchBrowser] Binary not found for ${browserName} at: ${binaryPath}\n` +
 			`   Linux checked: ~/.cache/brave/brave AND ~/Downloads/brave/brave`
 		);
 	}
@@ -109,30 +112,92 @@ function getBinaryPath(browserName) {
 	return binaryPath;
 }
 
-function cleanUpTempProfiles(ageLimitMinutes) {
-	if (!ageLimitMinutes || ageLimitMinutes < 10) return;
+const PROFILE_META_FILE = "_profile_meta.json";
 
-	console.log(`🧹 [Cleanup] Checking for temp profiles older than ${ageLimitMinutes} mins...`);
+/**
+ * Writes or updates the profile metadata file in a profile directory.
+ * On first creation: sets all fields.
+ * On subsequent launches: only updates `last_launched_at`.
+ */
+function writeProfileMeta(dirPath, type, cleanupMinutes) {
+	try {
+		const metaPath = path.join(dirPath, PROFILE_META_FILE);
+		const now = new Date().toISOString();
+
+		if (fs.existsSync(metaPath)) {
+			// Update last_launched_at only
+			const existing = JSON.parse(fs.readFileSync(metaPath, "utf-8"));
+			existing.last_launched_at = now;
+			fs.writeFileSync(metaPath, JSON.stringify(existing, null, 2), "utf-8");
+		} else {
+			// Create new meta
+			const meta = {
+				type,
+				created_at: now,
+				last_launched_at: now,
+				cleanup_minutes: cleanupMinutes,
+			};
+			fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2), "utf-8");
+		}
+	} catch (e) {
+		// Non-critical — don't break the launch
+	}
+}
+
+/**
+ * Scans both persistent and temp profile directories.
+ * Deletes profiles whose `_profile_meta.json` indicates they are expired.
+ * Skips the profile currently being launched (skipPath).
+ */
+function cleanUpProfiles(skipPath) {
 	const now = Date.now();
-	const limit = ageLimitMinutes * 60 * 1000;
 
-	try {
-		const files = fs.readdirSync(TEMP_DIR);
-		files.forEach((file) => {
-			const curPath = path.join(TEMP_DIR, file);
-			try {
-				const stats = fs.statSync(curPath);
-				if (stats.isDirectory() && now - stats.mtimeMs > limit) {
-					console.log(`   Deleting expired temp profile: ${file}`);
-					deleteDirectoryWithRetries(curPath);
+	function scanDir(dir) {
+		if (!fs.existsSync(dir)) return;
+		try {
+			const folders = fs.readdirSync(dir);
+			for (const folder of folders) {
+				const folderPath = path.join(dir, folder);
+				try {
+					const stats = fs.statSync(folderPath);
+					if (!stats.isDirectory()) continue;
+
+					// Skip the profile being launched right now
+					if (skipPath && path.resolve(folderPath) === path.resolve(skipPath)) continue;
+
+					const metaPath = path.join(folderPath, PROFILE_META_FILE);
+					if (!fs.existsSync(metaPath)) {
+						// Legacy temp profile without meta — use mtime, default 15 min
+						if (dir === TEMP_DIR && now - stats.mtimeMs > 15 * 60 * 1000) {
+							if (_cleanupLogs) console.log(`░░░░░ [Cleanup] Deleting legacy temp profile: ${folder}`);
+							deleteDirectoryWithRetries(folderPath);
+						}
+						continue;
+					}
+
+					const meta = JSON.parse(fs.readFileSync(metaPath, "utf-8"));
+					const cleanupMs = meta.cleanup_minutes;
+
+					// Skip if cleanup is disabled (null or 0)
+					if (!cleanupMs || cleanupMs <= 0) continue;
+
+					const lastLaunch = new Date(meta.last_launched_at).getTime();
+					if (now - lastLaunch > cleanupMs * 60 * 1000) {
+						if (_cleanupLogs) console.log(`░░░░░ [Cleanup] Deleting expired ${meta.type} profile: ${folder} (last launched ${Math.round((now - lastLaunch) / 60000)} mins ago)`);
+						deleteDirectoryWithRetries(folderPath);
+					}
+				} catch (e) {
+					// Ignore per-folder errors (locks, permission, corrupted meta)
 				}
-			} catch (e) {
-				// Ignore file lock errors
 			}
-		});
-	} catch (err) {
-		console.error("Cleanup Error:", err);
+		} catch (err) {
+			console.error("Cleanup scan error:", err);
+		}
 	}
+
+	if (_cleanupLogs) console.log("░░░░░ [Cleanup] Scanning for expired profiles...");
+	scanDir(PERSISTENT_DIR);
+	scanDir(TEMP_DIR);
 }
 
 /**
@@ -196,13 +261,31 @@ export async function launchBrowser({
 	camoufox_options = {}, // { geoip, humanize, ... }
 	multilogin_options = {}, // { profileId, os_type, canvas_noise, ... }
 
+	// Logging
+	launch_logs = false,
+	cleanup_logs = false,
+
 }) {
 	try {
 		if (custom_profile_path) throw new Error("Please use profile_path");
 
+		// Set module-level log flags
+		_launchLogs = launch_logs;
+		_cleanupLogs = cleanup_logs;
+
 		// Resolve path using the browser type to ensure prefixes
 		const fullPath = resolveProfilePath(profile_path, which_browser);
-		cleanUpTempProfiles(cleanupMinutes);
+
+		// Calculate effective cleanup minutes:
+		// Persistent: user value if > 0, otherwise null (never clean)
+		// Temp: user value if > 0, otherwise 15 min default
+		const isPersistent = !!profile_path;
+		const effectiveCleanupMinutes = cleanupMinutes > 0
+			? cleanupMinutes
+			: (isPersistent ? null : 15);
+
+		// Run cleanup scan — skips the profile being launched
+		cleanUpProfiles(fullPath);
 
 		let browserInstance;
 
@@ -223,6 +306,7 @@ export async function launchBrowser({
 					CapSolver,
 					humanize_options: effectiveHumanizeOptions,
 					spoof_fingerprint,
+					cleanupMinutes: effectiveCleanupMinutes,
 				});
 				break;
 			case "firefox":
@@ -232,6 +316,7 @@ export async function launchBrowser({
 					timezoneId,
 					humanize_options: effectiveHumanizeOptions,
 					spoof_fingerprint,
+					cleanupMinutes: effectiveCleanupMinutes,
 				});
 				break;
 			case "brave":
@@ -243,6 +328,7 @@ export async function launchBrowser({
 					CapSolver,
 					humanize_options: effectiveHumanizeOptions,
 					spoof_fingerprint,
+					cleanupMinutes: effectiveCleanupMinutes,
 				});
 				break;
 			case "camoufox":
@@ -252,6 +338,7 @@ export async function launchBrowser({
 					proxy,
 					timezoneId,
 					camoufox_options,
+					cleanupMinutes: effectiveCleanupMinutes,
 					// Spoof Fingerprint not needed for Camoufox
 				});
 				break;
@@ -269,7 +356,7 @@ export async function launchBrowser({
 
 		return browserInstance;
 	} catch (error) {
-		console.error("❌ [LaunchBrowser] Critical Error:", error.message || error);
+		console.error("░░░░░ [LaunchBrowser] Critical Error:", error.message || error);
 		return { browser: null, context: null, page: null, isBrowserRunning: () => false, closeBrowser: async () => false, launchError: error };
 	}
 }
@@ -277,12 +364,14 @@ export async function launchBrowser({
 // ==========================================================================
 // 4. ENGINE: CHROMIUM
 // ==========================================================================
-async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, humanize_options, spoof_fingerprint }) {
+async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, humanize_options, spoof_fingerprint, cleanupMinutes }) {
 	const isPersistent = !!profilePath;
 
 	// 1. Determine Path (Temp needs it for fingerprint storage, Persistent needs it for data)
 	const activePath = isPersistent ? profilePath : path.join(TEMP_DIR, crypto.randomUUID());
-	console.log(`🚀 Starting Chromium [${isPersistent ? "Persistent" : "Temp"}]: ${activePath}`);
+	if (!fs.existsSync(activePath)) fs.mkdirSync(activePath, { recursive: true });
+	writeProfileMeta(activePath, isPersistent ? "persistent" : "temp", cleanupMinutes);
+	if (_launchLogs) console.log(`░░░░░ Starting Chromium [${isPersistent ? "Persistent" : "Temp"}]: ${activePath}`);
 
 	// 2. Define Args
 	const args = [
@@ -403,12 +492,14 @@ async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, hum
 // ==========================================================================
 // 5. ENGINE: FIREFOX
 // ==========================================================================
-async function firefoxLauncher({ profilePath, proxy, timezoneId, humanize_options, spoof_fingerprint }) {
+async function firefoxLauncher({ profilePath, proxy, timezoneId, humanize_options, spoof_fingerprint, cleanupMinutes }) {
 	const isPersistent = !!profilePath;
 
 	// 1. Determine Path
 	const activePath = isPersistent ? profilePath : path.join(TEMP_DIR, crypto.randomUUID());
-	console.log(`🚀 Starting Firefox [${isPersistent ? "Persistent" : "Temp"}]: ${activePath}`);
+	if (!fs.existsSync(activePath)) fs.mkdirSync(activePath, { recursive: true });
+	writeProfileMeta(activePath, isPersistent ? "persistent" : "temp", cleanupMinutes);
+	if (_launchLogs) console.log(`░░░░░ Starting Firefox [${isPersistent ? "Persistent" : "Temp"}]: ${activePath}`);
 
 	const proxyObj = formatProxy(proxy);
 	const tz = timezoneId || undefined;
@@ -497,12 +588,13 @@ async function firefoxLauncher({ profilePath, proxy, timezoneId, humanize_option
 // ==========================================================================
 // 6. ENGINE: BRAVE
 // ==========================================================================
-async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, humanize_options, spoof_fingerprint }) {
+async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, humanize_options, spoof_fingerprint, cleanupMinutes }) {
 	const isPersistent = !!profilePath;
 	const activePath = isPersistent ? profilePath : path.join(TEMP_DIR, crypto.randomUUID());
 
-	console.log(`🚀 Starting Brave: ${activePath}`);
+	if (_launchLogs) console.log(`░░░░░ Starting Brave: ${activePath}`);
 	fs.mkdirSync(activePath, { recursive: true });
+	writeProfileMeta(activePath, isPersistent ? "persistent" : "temp", cleanupMinutes);
 
 	// ======================================================
 	// Persist spoof_fingerprint setting for persistent profiles
@@ -516,12 +608,12 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, humani
 			// Load saved settings from first launch
 			const savedSettings = JSON.parse(fs.readFileSync(settingsFilePath, "utf-8"));
 			effectiveSpoofFingerprint = savedSettings.spoof_fingerprint;
-			console.log(`📋 Using saved spoof_fingerprint: ${JSON.stringify(effectiveSpoofFingerprint)} (ignoring current: ${JSON.stringify(spoof_fingerprint)})`);
+			if (_launchLogs) console.log(`░░░░░ Using saved spoof_fingerprint: ${JSON.stringify(effectiveSpoofFingerprint)} (ignoring current: ${JSON.stringify(spoof_fingerprint)})`);
 		} else {
 			// First launch - save the current setting
 			const settings = { spoof_fingerprint: spoof_fingerprint };
 			fs.writeFileSync(settingsFilePath, JSON.stringify(settings, null, 2), "utf-8");
-			console.log(`📝 Saved spoof_fingerprint setting: ${JSON.stringify(spoof_fingerprint)}`);
+			if (_launchLogs) console.log(`░░░░░ Saved spoof_fingerprint setting: ${JSON.stringify(spoof_fingerprint)}`);
 		}
 	}
 
@@ -545,7 +637,7 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, humani
 
 		if (isPersistent) {
 			fs.writeFileSync(fingerprintFilePath, JSON.stringify(fingerprintData, null, 2), "utf-8");
-			console.log("📝 Generated and saved new fingerprint for Brave");
+			if (_launchLogs) console.log("░░░░░ Generated and saved new fingerprint for Brave");
 		}
 	}
 
@@ -569,7 +661,7 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, humani
 		prefs.brave.sidebar.sidebar_show_option = 3;
 		fs.writeFileSync(prefsFilePath, JSON.stringify(prefs, null, 2), "utf-8");
 	} catch (e) {
-		console.warn("⚠️ Could not modify Brave preferences:", e.message);
+		console.warn("░░░░░ Could not modify Brave preferences:", e.message);
 	}
 
 	const args = [
@@ -656,11 +748,11 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, humani
 
 
 	// ======================================================
-	// 🛠️ FIX: Close Extra Tabs (Brave Dashboard / Restore)
+	// ░░░░░ FIX: Close Extra Tabs (Brave Dashboard / Restore)
 	// ======================================================
 	const pages = context.pages();
 	if (pages.length > 1) {
-		console.log(`🧹 Found ${pages.length} tabs open in Brave. Closing extras...`);
+		if (_launchLogs) console.log(`░░░░░ Found ${pages.length} tabs open in Brave. Closing extras...`);
 		// Close all tabs except the last one (which is usually the fresh active one)
 		for (let i = 0; i < pages.length - 1; i++) {
 			await pages[i].close();
@@ -676,12 +768,13 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, humani
 // ==========================================================================
 // 7. ENGINE: CAMOUFOX
 // ==========================================================================
-async function camoufoxLauncher({ profilePath, proxy, timezoneId, camoufox_options = {} }) {
+async function camoufoxLauncher({ profilePath, proxy, timezoneId, camoufox_options = {}, cleanupMinutes }) {
 	const isPersistent = !!profilePath;
 	const activePath = isPersistent ? profilePath : path.join(TEMP_DIR, crypto.randomUUID());
 
-	console.log(`🚀 Starting camoufoxJs: ${activePath}`);
+	if (_launchLogs) console.log(`░░░░░ Starting camoufoxJs: ${activePath}`);
 	fs.mkdirSync(activePath, { recursive: true });
+	writeProfileMeta(activePath, isPersistent ? "persistent" : "temp", cleanupMinutes);
 
 	const proxyObj = formatProxy(proxy);
 	const tz = timezoneId || undefined;
@@ -746,7 +839,7 @@ async function camoufoxLauncher({ profilePath, proxy, timezoneId, camoufox_optio
 		// Save persistent config
 		if (isPersistent) {
 			fs.writeFileSync(fingerprintFilePath, JSON.stringify(launchConfig, null, 2), "utf-8");
-			console.log("📝 Generated and saved new launch config for Camoufox");
+			if (_launchLogs) console.log("░░░░░ Generated and saved new launch config for Camoufox");
 		}
 	}
 
@@ -810,7 +903,7 @@ async function launchExistingMultiloginProfile(profileId, humanize_options = nul
 		if (response.status === 400) {
 			const errorJson = await response.json().catch(() => null);
 			if (errorJson?.status?.error_code === "PROFILE_ALREADY_RUNNING") {
-				console.log(`⚠️ Profile ${profileId} is running. Restarting...`);
+				if (_launchLogs) console.log(`░░░░░ Profile ${profileId} is running. Restarting...`);
 				await stopMultiloginProfile(profileId);
 				await sleep(5000);
 				response = await fetch(startUrl, {
@@ -830,7 +923,7 @@ async function launchExistingMultiloginProfile(profileId, humanize_options = nul
 
 		const data = await response.json();
 		const port = data.data.port;
-		console.log(`✅ Multilogin Profile ${profileId} started on port ${port}`);
+		if (_launchLogs) console.log(`░░░░░ Multilogin Profile ${profileId} started on port ${port}`);
 
 		browser = await chromium.connectOverCDP(`http://localhost:${port}`);
 		context = browser.contexts()[0];
@@ -904,7 +997,7 @@ async function launchQuickMultiloginProfile({ os_type, proxy, canvas_noise, medi
 
 		profileId = json.data.id;
 		const port = json.data.port;
-		console.log(`✅ Quick Profile Created: ${profileId} on port ${port}`);
+		if (_launchLogs) console.log(`░░░░░ Quick Profile Created: ${profileId} on port ${port}`);
 
 		browser = await chromium.connectOverCDP(`http://localhost:${port}`);
 		context = browser.contexts()[0];
@@ -944,7 +1037,7 @@ async function stopMultiloginProfile(profileId) {
 			}
 			throw new Error(txt);
 		}
-		console.log(`🛑 Profile ${profileId} stopped.`);
+		if (_launchLogs) console.log(`░░░░░ Profile ${profileId} stopped.`);
 		return { error: null };
 	} catch (err) {
 		console.error(`Error stopping ${profileId}:`, err);
@@ -999,7 +1092,7 @@ function createBrowserController(browser, context, page, dirToDelete = null, hum
 
 	const closeBrowser = async () => {
 		try {
-			console.log("🔒 Closing browser session...");
+			if (_launchLogs) console.log("░░░░░ Closing browser session...");
 			if (context) await context.close();
 			if (browser && typeof browser.close === "function" && browser !== context) {
 				try {
@@ -1008,9 +1101,9 @@ function createBrowserController(browser, context, page, dirToDelete = null, hum
 			}
 			if (dirToDelete) {
 				if (dirToDelete.includes("persistent")) {
-					console.warn(`⚠️  Safety Block: Attempted to delete persistent profile: ${dirToDelete}`);
+					console.warn(`░░░░░  Safety Block: Attempted to delete persistent profile: ${dirToDelete}`);
 				} else {
-					console.log(`🗑️  Deleting temp profile: ${dirToDelete}`);
+					if (_launchLogs) console.log(`░░░░░  Deleting temp profile: ${dirToDelete}`);
 					await deleteDirectoryWithRetries(dirToDelete);
 				}
 			}

package/src/utility/proxy-utility/proxy-chain.js

@@ -190,7 +190,7 @@ export async function startProxyServer({
 	// 2. Port
 	const selectedPort = await findAvailablePort(50001, 50010);
 	if (!selectedPort) {
-		console.error("❌ Critical Error: No available ports.");
+		console.error("░░ Critical Error: No available ports.");
 		return null;
 	}
 
@@ -218,8 +218,8 @@ export async function startProxyServer({
 	]);
 
 	// Warn only if proxy was configured (URL exists) but details came back null (Connection failed)
-	if (upstreamProxies.p1 && !p1Details) console.warn("⚠️ Warning: PROXY_1 configured but unreachable.");
-	if (upstreamProxies.p2 && !p2Details) console.warn("⚠️ Warning: PROXY_2 configured but unreachable.");
+	if (upstreamProxies.p1 && !p1Details) console.warn("░░ Warning: PROXY_1 configured but unreachable.");
+	if (upstreamProxies.p2 && !p2Details) console.warn("░░ Warning: PROXY_2 configured but unreachable.");
 
 	// 5. Stats
 	const stats = {
@@ -239,6 +239,9 @@ export async function startProxyServer({
 	const connectionMap = {}; // Maps connectionId -> { type: "..." }
 	let serverRunning = false;
 
+	// Track all open sockets so we can force-destroy them on close
+	const activeSockets = new Set();
+
 	// 6. Server
 	const server = new ProxyChain.Server({
 		port: selectedPort,
@@ -327,13 +330,30 @@ export async function startProxyServer({
 	try {
 		await server.listen();
 		serverRunning = true;
-		console.log(`✅ Local Proxy Started: http://127.0.0.1:${selectedPort}`);
+
+		// Track sockets so closeServer() can destroy them all
+		server.server.on('connection', (socket) => {
+			activeSockets.add(socket);
+			socket.once('close', () => activeSockets.delete(socket));
+
+			// Intercept pipe to catch the upstream target sockets created by proxy-chain
+			const originalPipe = socket.pipe;
+			socket.pipe = function(destination, options) {
+				if (destination && typeof destination.destroy === 'function') {
+					activeSockets.add(destination);
+					destination.once('close', () => activeSockets.delete(destination));
+				}
+				return originalPipe.apply(this, arguments);
+			};
+		});
+
+		console.log(`░░ Local Proxy Started: http://127.0.0.1:${selectedPort}`);
 	} catch (err) {
-		console.error("❌ Failed to start proxy server:", err);
+		console.error("░░ Failed to start proxy server:", err);
 		return null;
 	}
 
-	const formatBytes = (bytes) => (bytes / 1024 / 1024).toFixed(2);
+	const formatBytes = (bytes) => (bytes / 1024 / 1024).toFixed(3);
 
 	const getProxyStatsFormatted = () => {
 		const formatted = {};
@@ -397,15 +417,21 @@ export async function startProxyServer({
 			await server.close(true);
 			serverRunning = false;
 
+			// Force-destroy any lingering sockets so Node can exit
+			for (const socket of activeSockets) {
+				socket.destroy();
+			}
+			activeSockets.clear();
+
 			// Auto console.log stats on close
 			if (proxy_stats) {
-				console.log("📊 Proxy Stats:", getProxyStatsFormatted());
+				console.log("░░ Proxy Stats:", getProxyStatsFormatted());
 			}
 			if (host_stats) {
-				console.log("🌐 Host Stats:", getHostStatsFormatted());
+				console.log("░░ Host Stats:", getHostStatsFormatted());
 			}
 
-			console.log("🔒 Proxy server closed.");
+			console.log("░░ Proxy server closed.");
 		},
 
 		getProxyStats: getProxyStatsFormatted,