arn-browser 0.1.6 → 0.1.8

package/src/utility/puppeteer/ppLaunch.js

@@ -0,0 +1,723 @@
+/**
+ * @file launchPuppeteer.js
+ * @description Puppeteer CDP-only browser launcher.
+ * Supports: Chrome, Brave, and Multilogin (via CDP connect).
+ * Handles: Persistent profiles (with prefixes), temp profiles, and cleanup.
+ */
+
+import fs from "fs";
+import path from "path";
+import os from "os";
+import crypto from "node:crypto";
+import { spawn } from "child_process";
+import puppeteer from "puppeteer-core";
+import { setTimeout as sleep } from "timers/promises";
+import { FingerprintInjector } from "fingerprint-injector";
+import { FingerprintGenerator } from "fingerprint-generator";
+
+// Internal Utilities
+import { getMultiloginToken } from "../mlx_token.js";
+import { deleteDirectoryWithRetries } from "../deleteDirectory.js";
+
+// ==========================================================================
+// 1. CONFIGURATION & CONSTANTS
+// ==========================================================================
+
+const MULTILOGIN_LAUNCHER_URL = "https://launcher.mlx.yt:45001";
+const MULTILOGIN_FOLDER_ID = "bad9e7e1-cfab-4c8d-bd19-91aa82929711";
+
+const ARN_BROWSER_DIR = path.join(os.homedir(), ".arn-browser");
+const BASE_PROFILE_DIR = path.join(ARN_BROWSER_DIR, "profiles", "pp");
+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 launchPuppeteer options)
+let _launchLogs = false;
+let _cleanupLogs = false;
+
+// Detect OS for fingerprint generation
+const detectedOs = process.platform === "win32" ? "windows" : process.platform === "darwin" ? "macos" : "linux";
+
+/**
+ * Helper to generate consistent fingerprint options for Puppeteer.
+ * @param {object|null} screenOptions - Optional screen constraints { minWidth, maxWidth, minHeight, maxHeight }
+ */
+function getFingerprintConfig(screenOptions = null) {
+	const config = {
+		devices: ["desktop"],
+		operatingSystems: [detectedOs],
+		locales: ["en-US"],
+		browsers: [{ name: "chrome", minVersion: 141 }],
+		screen: {},
+	};
+
+	if (screenOptions && typeof screenOptions === 'object') {
+		if (screenOptions.minWidth) config.screen.minWidth = screenOptions.minWidth;
+		if (screenOptions.maxWidth) config.screen.maxWidth = screenOptions.maxWidth;
+		if (screenOptions.minHeight) config.screen.minHeight = screenOptions.minHeight;
+		if (screenOptions.maxHeight) config.screen.maxHeight = screenOptions.maxHeight;
+	}
+
+	return config;
+}
+
+// ==========================================================================
+// 2. HELPER FUNCTIONS
+// ==========================================================================
+
+const PROFILE_META_FILE = "_profile_meta.json";
+
+/**
+ * Resolves the persistent path with a browser-specific prefix.
+ */
+function resolveProfilePath(nameOrPath, browserName) {
+	if (!nameOrPath) return null;
+
+	if (path.isAbsolute(nameOrPath)) return nameOrPath;
+
+	let prefix = browserName.toLowerCase();
+	if (prefix.includes("brave")) prefix = "brave";
+	else if (prefix.includes("chrome") || prefix.includes("chromium")) prefix = "chrome";
+
+	const folderName = `${prefix}_${nameOrPath}`;
+	return path.join(PERSISTENT_DIR, folderName);
+}
+
+/**
+ * Locates binaries for Chrome and Brave from the installed browsers.
+ * Uses ~/.arn-browser/browsers/{browser}/{executable}
+ */
+function getBinaryPath(browserName) {
+	const isWindows = process.platform === "win32";
+	const browsersDir = path.join(ARN_BROWSER_DIR, "browsers");
+
+	const binaryMap = {
+		brave: isWindows
+			? path.join(browsersDir, "brave", "brave.exe")
+			: path.join(browsersDir, "brave", "brave"),
+		chrome: isWindows
+			? path.join(browsersDir, "chromium", "chrome.exe")
+			: path.join(browsersDir, "chromium", "chrome"),
+	};
+
+	const binaryPath = binaryMap[browserName];
+	if (!binaryPath) {
+		throw new Error(`░░░░░ [LaunchPuppeteer] Unknown browser: ${browserName}`);
+	}
+
+	if (!fs.existsSync(binaryPath)) {
+		throw new Error(
+			`░░░░░ [LaunchPuppeteer] ${browserName} binary not found at: ${binaryPath}\n` +
+			`   Run "node bin/cli.js install" to install browsers.`
+		);
+	}
+
+	return binaryPath;
+}
+
+/**
+ * Writes or updates the profile metadata file.
+ */
+function writeProfileMeta(dirPath, type, cleanupMinutes) {
+	try {
+		const metaPath = path.join(dirPath, PROFILE_META_FILE);
+		const now = new Date().toISOString();
+
+		if (fs.existsSync(metaPath)) {
+			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 {
+			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
+	}
+}
+
+/**
+ * Scans profile directories and deletes expired profiles.
+ */
+function cleanUpProfiles(skipPath) {
+	const now = Date.now();
+
+	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;
+
+					if (skipPath && path.resolve(folderPath) === path.resolve(skipPath)) continue;
+
+					const metaPath = path.join(folderPath, PROFILE_META_FILE);
+					if (!fs.existsSync(metaPath)) {
+						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;
+
+					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
+				}
+			}
+		} catch (err) {
+			console.error("Cleanup scan error:", err);
+		}
+	}
+
+	if (_cleanupLogs) console.log("░░░░░ [Cleanup] Scanning for expired profiles...");
+	scanDir(PERSISTENT_DIR);
+	scanDir(TEMP_DIR);
+}
+
+/**
+ * Formats proxy into standard object.
+ */
+function formatProxy(proxy) {
+	if (!proxy) return undefined;
+	if (typeof proxy === "string") return { server: proxy };
+
+	const p = { server: `${proxy.type || "http"}://${proxy.host}:${proxy.port}` };
+	if (proxy.user) {
+		p.username = proxy.user;
+		p.password = proxy.pass;
+	}
+	return p;
+}
+
+// ==========================================================================
+// 3. MAIN LAUNCHER ENTRY POINT
+// ==========================================================================
+
+export async function ppLaunch({
+	// Browser selection
+	which_browser = "chrome",
+
+	// Path & Storage
+	profile_path = null,
+	cleanupMinutes = 0,
+
+	// Network
+	proxy = null,
+
+	// Extra browser CLI args
+	extraArgs = [],
+
+	// Spoof Fingerprint
+	// - false: No spoofing
+	// - true: Spoof with default screen
+	// - { minWidth?, maxWidth?, minHeight?, maxHeight? }: Spoof with screen constraints
+	spoof_fingerprint = false,
+
+	// Multilogin
+	multilogin_options = {},
+
+	// Logging
+	launch_logs = false,
+	cleanup_logs = false,
+} = {}) {
+	try {
+		// 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);
+
+		// Calculate effective cleanup minutes
+		const isPersistent = !!profile_path;
+		const effectiveCleanupMinutes = cleanupMinutes > 0
+			? cleanupMinutes
+			: (isPersistent ? null : 15);
+
+		// Run cleanup scan
+		cleanUpProfiles(fullPath);
+
+		let result;
+
+		switch (which_browser) {
+			case "chrome":
+			case "chromium":
+				result = await chromeLauncher({
+					profilePath: fullPath,
+					proxy,
+					extraArgs,
+					spoof_fingerprint,
+					cleanupMinutes: effectiveCleanupMinutes,
+				});
+				break;
+			case "brave":
+				result = await braveLauncher({
+					profilePath: fullPath,
+					proxy,
+					extraArgs,
+					spoof_fingerprint,
+					cleanupMinutes: effectiveCleanupMinutes,
+				});
+				break;
+			case "multilogin":
+				result = await multiloginLauncher({
+					proxy,
+					multilogin_options,
+				});
+				break;
+			default:
+				throw new Error(`[LaunchPuppeteer] Unknown browser type: ${which_browser}. Supported: chrome, brave, multilogin`);
+		}
+
+		return result;
+	} catch (error) {
+		console.error("░░░░░ [LaunchPuppeteer] Critical Error:", error.message || error);
+		return { browser: null, context: null, page: null, isBrowserRunning: () => false, closeBrowser: async () => false, launchError: error };
+	}
+}
+
+// ==========================================================================
+// 4. ENGINE: CHROME (CDP)
+// ==========================================================================
+
+async function chromeLauncher({ profilePath, proxy, extraArgs, spoof_fingerprint, cleanupMinutes }) {
+	const isPersistent = !!profilePath;
+	const activePath = isPersistent ? profilePath : path.join(TEMP_DIR, crypto.randomUUID());
+
+	fs.mkdirSync(activePath, { recursive: true });
+	writeProfileMeta(activePath, isPersistent ? "persistent" : "temp", cleanupMinutes);
+	if (_launchLogs) console.log(`░░░░░ Starting Chrome [${isPersistent ? "Persistent" : "Temp"}]: ${activePath}`);
+
+	const binaryPath = getBinaryPath("chrome");
+	return await spawnAndConnect({
+		binaryPath,
+		profilePath: activePath,
+		isPersistent,
+		proxy,
+		extraArgs,
+		spoof_fingerprint,
+		browserLabel: "Chrome",
+	});
+}
+
+// ==========================================================================
+// 5. ENGINE: BRAVE (CDP)
+// ==========================================================================
+
+async function braveLauncher({ profilePath, proxy, extraArgs, spoof_fingerprint, cleanupMinutes }) {
+	const isPersistent = !!profilePath;
+	const activePath = isPersistent ? profilePath : path.join(TEMP_DIR, crypto.randomUUID());
+
+	fs.mkdirSync(activePath, { recursive: true });
+	writeProfileMeta(activePath, isPersistent ? "persistent" : "temp", cleanupMinutes);
+	if (_launchLogs) console.log(`░░░░░ Starting Brave [${isPersistent ? "Persistent" : "Temp"}]: ${activePath}`);
+
+	// ======================================================
+	// Disable Brave Sidebar via Preferences
+	// ======================================================
+	const prefsFilePath = path.join(activePath, "Default", "Preferences");
+	const prefsDir = path.dirname(prefsFilePath);
+	if (!fs.existsSync(prefsDir)) fs.mkdirSync(prefsDir, { recursive: true });
+
+	try {
+		let prefs = {};
+		if (fs.existsSync(prefsFilePath)) {
+			prefs = JSON.parse(fs.readFileSync(prefsFilePath, "utf-8"));
+		}
+		if (!prefs.brave) prefs.brave = {};
+		if (!prefs.brave.sidebar) prefs.brave.sidebar = {};
+		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);
+	}
+
+	const binaryPath = getBinaryPath("brave");
+	const braveArgs = [
+		"--disable-features=Translate,BraveRewards,BraveWallet,BraveNews,Sidebar,SidePanel",
+		"--homepage=about:blank",
+	];
+
+	return await spawnAndConnect({
+		binaryPath,
+		profilePath: activePath,
+		isPersistent,
+		proxy,
+		extraArgs: [...braveArgs, ...extraArgs],
+		spoof_fingerprint,
+		browserLabel: "Brave",
+	});
+}
+
+// ==========================================================================
+// 6. CDP SPAWN & CONNECT (Shared between Chrome & Brave)
+// ==========================================================================
+
+async function spawnAndConnect({ binaryPath, profilePath, isPersistent, proxy, extraArgs = [], spoof_fingerprint = false, browserLabel = "Browser" }) {
+	let browser;
+	let closing = false;
+	let signalHandler;
+
+	// Random 5-digit port (10000–65535)
+	const debugPort = Math.floor(Math.random() * 55535) + 10000;
+
+	const proxyObj = formatProxy(proxy);
+
+	const args = [
+		`--remote-debugging-port=${debugPort}`,
+		`--user-data-dir=${profilePath}`,
+		"--no-first-run",
+		"--no-default-browser-check",
+		"--start-maximized",
+
+		// --- Stealth & Anti-Detection ---
+		"--test-type",
+		"--disable-blink-features=AutomationControlled",
+
+		// --- PREVENT EXTRA TABS ---
+		"--disable-restore-session-state",
+
+		// --- Error Suppression ---
+		"--disable-session-crashed-bubble",
+		"--hide-crash-restore-bubble",
+
+		// --- Silence & Networking ---
+		"--disable-background-networking",
+		"--disable-background-timer-throttling",
+		"--disable-breakpad",
+		"--disable-crash-reporter",
+		"--disable-component-update",
+		"--disable-sync",
+		"--disable-domain-reliability",
+		"--disable-client-side-phishing-detection",
+		"--disable-infobars",
+
+		...extraArgs,
+	];
+
+	if (proxyObj) {
+		args.push(`--proxy-server=${proxyObj.server}`);
+	}
+
+	// Spawn browser
+	const chrome = spawn(binaryPath, args, {
+		stdio: "ignore",
+		detached: true,
+	});
+
+	// Unref so Node.js can exit independently
+	chrome.unref();
+
+	// Cleanup function
+	const cleanup = async () => {
+		if (closing) return false;
+		closing = true;
+
+		if (signalHandler) {
+			process.off("SIGINT", signalHandler);
+			process.off("SIGTERM", signalHandler);
+			process.off("SIGHUP", signalHandler);
+		}
+
+		try {
+			if (browser?.connected) await browser.close();
+		} catch { }
+
+		try {
+			if (chrome.pid) process.kill(-chrome.pid, "SIGTERM");
+		} catch { }
+
+		// Delete temp profile
+		if (!isPersistent && profilePath) {
+			try {
+				if (_launchLogs) console.log(`░░░░░ Deleting temp profile: ${profilePath}`);
+				await deleteDirectoryWithRetries(profilePath);
+			} catch { }
+		}
+
+		return true;
+	};
+
+	// Register signal handlers
+	signalHandler = async () => {
+		await cleanup();
+		process.exit(0);
+	};
+	process.once("SIGINT", signalHandler);
+	process.once("SIGTERM", signalHandler);
+	process.once("SIGHUP", signalHandler);
+
+	if (_launchLogs) console.log(`░░░░░ ${browserLabel} started on port ${debugPort}`);
+	await sleep(2000);
+
+	// Connect via CDP
+	try {
+		browser = await puppeteer.connect({
+			browserURL: `http://127.0.0.1:${debugPort}`,
+			defaultViewport: null,
+		});
+
+		if (_launchLogs) console.log(`░░░░░ Connected to ${browserLabel} via CDP (port ${debugPort})`);
+
+		// Get page — apply fingerprint injection if spoof_fingerprint is enabled
+		const pages = await browser.pages();
+		const page = pages[0] ?? (await browser.newPage());
+
+		// Fingerprint injection logic:
+		// 1. If persistent profile has a saved fingerprint.json → ALWAYS use it (even if spoof_fingerprint is false)
+		// 2. If spoof_fingerprint is truthy → generate new fingerprint (save it for persistent profiles)
+		// 3. Otherwise → no fingerprint injection
+		const fingerprintFilePath = path.join(profilePath, "fingerprint.json");
+		const hasSavedFingerprint = isPersistent && fs.existsSync(fingerprintFilePath);
+
+		if (hasSavedFingerprint || spoof_fingerprint) {
+			let fingerprintData;
+
+			if (hasSavedFingerprint) {
+				// Persistent: reuse saved fingerprint (regardless of spoof_fingerprint setting)
+				fingerprintData = JSON.parse(fs.readFileSync(fingerprintFilePath, "utf-8"));
+				if (_launchLogs) console.log(`░░░░░ Loaded saved fingerprint for ${browserLabel}`);
+			} else {
+				// Generate new fingerprint
+				const screenOptions = (typeof spoof_fingerprint === 'object') ? spoof_fingerprint : null;
+				const fpConfig = getFingerprintConfig(screenOptions);
+				fingerprintData = new FingerprintGenerator().getFingerprint(fpConfig);
+
+				// Save for persistent profiles
+				if (isPersistent) {
+					fs.writeFileSync(fingerprintFilePath, JSON.stringify(fingerprintData, null, 2), "utf-8");
+					if (_launchLogs) console.log(`░░░░░ Generated and saved new fingerprint for ${browserLabel}`);
+				}
+			}
+
+			// Inject onto existing page
+			const injector = new FingerprintInjector();
+			await injector.attachFingerprintToPuppeteer(page, fingerprintData);
+
+			if (_launchLogs) console.log(`░░░░░ Fingerprint injected into ${browserLabel} page`);
+		}
+
+		return {
+			browser,
+			context: browser,
+			page,
+			isBrowserRunning: () => !!browser?.connected,
+			closeBrowser: cleanup,
+			launchError: null,
+		};
+	} catch (error) {
+		console.error(`░░░░░ Failed to connect to ${browserLabel} on port ${debugPort}:`, error.message);
+		await cleanup();
+		return {
+			browser: null,
+			context: null,
+			page: null,
+			isBrowserRunning: () => false,
+			closeBrowser: async () => false,
+			launchError: error,
+		};
+	}
+}
+
+// ==========================================================================
+// 7. ENGINE: MULTILOGIN (CDP via Puppeteer)
+// ==========================================================================
+
+async function multiloginLauncher({ proxy, multilogin_options = {} }) {
+	const {
+		profileId = null,
+		os_type = (process.platform === "win32" ? "windows" : process.platform === "darwin" ? "macos" : "linux"),
+		canvas_noise = true,
+		media_masking = true,
+		audio_masking = true,
+	} = multilogin_options;
+
+	if (profileId) {
+		return await launchExistingMultiloginProfile(profileId);
+	} else {
+		return await launchQuickMultiloginProfile({
+			os_type,
+			proxy,
+			canvas_noise,
+			media_masking,
+			audio_masking,
+		});
+	}
+}
+
+async function launchExistingMultiloginProfile(profileId) {
+	const startUrl = `${MULTILOGIN_LAUNCHER_URL}/api/v2/profile/f/${MULTILOGIN_FOLDER_ID}/p/${profileId}/start?automation_type=playwright&headless_mode=false`;
+	let browser;
+
+	try {
+		const token = await getMultiloginToken();
+		let response = await fetch(startUrl, {
+			method: "GET",
+			headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "X-Strict-Mode": "true" },
+		});
+
+		if (response.status === 400) {
+			const errorJson = await response.json().catch(() => null);
+			if (errorJson?.status?.error_code === "PROFILE_ALREADY_RUNNING") {
+				if (_launchLogs) console.log(`░░░░░ Profile ${profileId} is running. Restarting...`);
+				await stopMultiloginProfile(profileId);
+				await sleep(5000);
+				response = await fetch(startUrl, {
+					method: "GET",
+					headers: {
+						Authorization: `Bearer ${await getMultiloginToken()}`,
+						Accept: "application/json",
+						"X-Strict-Mode": "true",
+					},
+				});
+			} else {
+				throw new Error(`Multilogin 400 Error: ${JSON.stringify(errorJson)}`);
+			}
+		}
+
+		if (!response.ok) throw new Error(`Failed to start profile: ${await response.text()}`);
+
+		const data = await response.json();
+		const port = data.data.port;
+		if (_launchLogs) console.log(`░░░░░ Multilogin Profile ${profileId} started on port ${port}`);
+
+		browser = await puppeteer.connect({
+			browserURL: `http://127.0.0.1:${port}`,
+			defaultViewport: null,
+		});
+
+		const pages = await browser.pages();
+		const page = pages[0] ?? (await browser.newPage());
+
+		const closeBrowser = async () => {
+			try {
+				if (browser?.connected) await browser.close();
+			} catch { }
+			return await stopMultiloginProfile(profileId);
+		};
+
+		return { browser, context: browser, page, isBrowserRunning: () => !!browser?.connected, closeBrowser, launchError: null };
+	} catch (error) {
+		console.error("Multilogin Launch Error:", error.message);
+		try { await stopMultiloginProfile(profileId); } catch { }
+		return { browser: null, context: null, page: null, isBrowserRunning: () => false, closeBrowser: async () => false, launchError: error };
+	}
+}
+
+async function launchQuickMultiloginProfile({ os_type, proxy, canvas_noise, media_masking, audio_masking }) {
+	const createUrl = `${MULTILOGIN_LAUNCHER_URL}/api/v3/profile/quick`;
+	let browser, profileId;
+
+	const requestBody = {
+		browser_type: "mimic",
+		os_type,
+		automation: "playwright",
+		is_headless: false,
+		parameters: {
+			flags: {
+				audio_masking: audio_masking ? "mask" : "natural",
+				media_devices_masking: media_masking ? "mask" : "natural",
+				screen_masking: "natural",
+				canvas_noise: canvas_noise ? "mask" : "natural",
+				proxy_masking: proxy ? "custom" : "disabled",
+			},
+		},
+		quickProfilesCount: 1,
+	};
+
+	if (proxy) {
+		const pObj = formatProxy(proxy);
+		if (pObj) {
+			const u = new URL(pObj.server);
+			requestBody.parameters.proxy = {
+				type: "http",
+				host: u.hostname,
+				port: Number(u.port),
+				username: pObj.username || "",
+				password: pObj.password || "",
+			};
+		}
+	}
+
+	try {
+		const token = await getMultiloginToken();
+		const response = await fetch(createUrl, {
+			method: "POST",
+			headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
+			body: JSON.stringify(requestBody),
+		});
+
+		if (!response.ok) throw new Error(await response.text());
+		const json = await response.json();
+
+		profileId = json.data.id;
+		const port = json.data.port;
+		if (_launchLogs) console.log(`░░░░░ Quick Profile Created: ${profileId} on port ${port}`);
+
+		browser = await puppeteer.connect({
+			browserURL: `http://127.0.0.1:${port}`,
+			defaultViewport: null,
+		});
+
+		const pages = await browser.pages();
+		const page = pages[0] ?? (await browser.newPage());
+
+		const closeBrowser = async () => {
+			try {
+				if (browser?.connected) await browser.close();
+			} catch { }
+			return await stopMultiloginProfile(profileId);
+		};
+
+		return { browser, context: browser, page, isBrowserRunning: () => !!browser?.connected, closeBrowser, launchError: null };
+	} catch (error) {
+		console.error("Quick Profile Error:", error);
+		if (profileId) await stopMultiloginProfile(profileId);
+		return { browser: null, context: null, page: null, isBrowserRunning: () => false, closeBrowser: async () => false, launchError: error };
+	}
+}
+
+async function stopMultiloginProfile(profileId) {
+	const stopUrl = `${MULTILOGIN_LAUNCHER_URL}/api/v1/profile/stop/p/${profileId}`;
+	try {
+		const token = await getMultiloginToken();
+		const response = await fetch(stopUrl, {
+			method: "GET",
+			headers: { Authorization: `Bearer ${token}`, Accept: "application/json" },
+		});
+
+		if (!response.ok) {
+			const txt = await response.text();
+			if (response.status === 500 && txt.includes("profile already stopped")) {
+				return { error: null };
+			}
+			throw new Error(txt);
+		}
+		if (_launchLogs) console.log(`░░░░░ Profile ${profileId} stopped.`);
+		return { error: null };
+	} catch (err) {
+		console.error(`Error stopping ${profileId}:`, err);
+		return { error: err };
+	}
+}