arn-browser 0.0.11 → 0.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "arn-browser",
-	"version": "0.0.11",
+	"version": "0.0.13",
 	"description": "A lightweight, browser autmation helper.",
 	"main": "src/index.js",
 	"types": "src/index.d.ts",
@@ -13,7 +13,7 @@
 	"dependencies": {
 		"@aws-sdk/client-ec2": "^3.946.0",
 		"@ghostery/adblocker": "^2.13.0",
-		"arn-knexjs": "^0.0.2",
+		"arn-knexjs": "^0.0.3",
 		"camoufox-js": "^0.8.4",
 		"dotenv": "^17.2.3",
 		"fingerprint-generator": "^2.1.78",

package/src/utility/launchBrowser.d.ts

@@ -181,6 +181,18 @@ export interface LaunchOptions {
 	 */
 	maxWidth?: number;
 
+	/**
+	 * Whether to spoof browser fingerprint with FingerprintInjector.
+	 * When true: Applies userAgent, viewport, locale from fingerprintData and uses FingerprintInjector.
+	 * When false: Uses null viewport and applies stealth script only.
+	 * 
+	 * **For persistent Brave profiles:** The value is locked on first launch.
+	 * Subsequent launches will use the saved value, ignoring the current parameter.
+	 * 
+	 * Default: false
+	 */
+	spoof_fingerprint?: boolean;
+
 	// ========================================================================
 	// 5. ENGINE SPECIFIC GROUPS
 	// ========================================================================

package/src/utility/launchBrowser.js

@@ -180,11 +180,15 @@ export async function launchBrowser({
 
 	which_browser = "chromium",
 	CapSolver = false,
+	humanize_options = {}, // { humanize, maxTime, minTime, showCursor } - defaults to enabled for non-camoufox
+
+	// Spoof Fingerprint
+	spoof_fingerprint = false,
 
 	// Browser Specific Grouped Options
 	camoufox_options = {}, // { geoip, humanize, ... }
 	multilogin_options = {}, // { profileId, os_type, canvas_noise, ... }
-	humanize_options = {}, // { humanize, maxTime, minTime, showCursor } - defaults to enabled for non-camoufox
+
 }) {
 	try {
 		if (custom_profile_path) throw new Error("Please use profile_path");
@@ -212,6 +216,7 @@ export async function launchBrowser({
 					CapSolver,
 					maxWidth,
 					humanize_options: effectiveHumanizeOptions,
+					spoof_fingerprint,
 				});
 				break;
 			case "firefox":
@@ -221,6 +226,7 @@ export async function launchBrowser({
 					timezoneId,
 					maxWidth,
 					humanize_options: effectiveHumanizeOptions,
+					spoof_fingerprint,
 				});
 				break;
 			case "brave":
@@ -232,6 +238,7 @@ export async function launchBrowser({
 					CapSolver,
 					maxWidth,
 					humanize_options: effectiveHumanizeOptions,
+					spoof_fingerprint,
 				});
 				break;
 			case "camoufox":
@@ -242,6 +249,7 @@ export async function launchBrowser({
 					timezoneId,
 					maxWidth,
 					camoufox_options,
+					// Spoof Fingerprint not needed for Camoufox
 				});
 				break;
 			case "multilogin":
@@ -249,6 +257,7 @@ export async function launchBrowser({
 					proxy,
 					multilogin_options,
 					humanize_options: effectiveHumanizeOptions,
+					// Spoof Fingerprint not needed for Multilogin
 				});
 				break;
 			default:
@@ -265,7 +274,9 @@ export async function launchBrowser({
 // ==========================================================================
 // 4. ENGINE: CHROMIUM
 // ==========================================================================
-async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, maxWidth, humanize_options }) {
+async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, maxWidth, humanize_options
+	, spoof_fingerprint
+}) {
 	const isPersistent = !!profilePath;
 
 	// 1. Determine Path (Temp needs it for fingerprint storage, Persistent needs it for data)
@@ -278,6 +289,11 @@ async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, max
 		// --- Stealth & Anti-Detection ---
 		"--disable-blink-features=AutomationControlled",
 		// "--disable-features=UserAgentClientHint",
+
+		// --- Window Size ---
+		"--start-maximized",
+
+
 		// --- PREVENT EXTRA TABS ---
 		// "--homepage=about:blank",
 		"--disable-restore-session-state",
@@ -324,11 +340,20 @@ async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, max
 				ignoreDefaultArgs: ignoreDefaultArgs,
 			});
 
-			// Inject the fingerprint
-			const context = await newInjectedContext(browser, {
-				fingerprint: fingerprintData,
-				timezoneId: tz,
-			});
+			let context;
+			if (spoof_fingerprint) {
+				// Inject the fingerprint
+				context = await newInjectedContext(browser, {
+					fingerprint: fingerprintData,
+					timezoneId: tz,
+				});
+			} else {
+				context = await browser.newContext({
+					timezoneId: tz,
+				});
+				// Manual Stealth Script
+				await addStealthScript(context);
+			}
 
 			const page = context.pages()[0] || (await context.newPage());
 
@@ -343,6 +368,7 @@ async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, max
 	// BRANCH B: PERSISTENT PROFILE (launchPersistentContext + Manual Script)
 	// ==================================================================
 	else {
+		// spoof_fingerprint not needed for isPersistent in chromium
 		try {
 			if (!fs.existsSync(activePath)) fs.mkdirSync(activePath, { recursive: true });
 
@@ -372,7 +398,7 @@ async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, max
 // ==========================================================================
 // 5. ENGINE: FIREFOX
 // ==========================================================================
-async function firefoxLauncher({ profilePath, proxy, timezoneId, maxWidth, humanize_options }) {
+async function firefoxLauncher({ profilePath, proxy, timezoneId, maxWidth, humanize_options, spoof_fingerprint }) {
 	const isPersistent = !!profilePath;
 
 	// 1. Determine Path
@@ -404,10 +430,21 @@ async function firefoxLauncher({ profilePath, proxy, timezoneId, maxWidth, human
 				firefoxUserPrefs: firefoxUserPrefs,
 			});
 
-			const context = await newInjectedContext(browser, {
-				fingerprint: fingerprintData,
-				timezoneId: tz,
-			});
+			let context;
+			if (spoof_fingerprint) {
+				context = await newInjectedContext(browser, {
+					fingerprint: fingerprintData,
+					timezoneId: tz,
+				});
+			}
+			// Spoof Fingerprint not needed for Firefox
+			else {
+				context = await browser.newContext({
+					timezoneId: tz,
+				});
+				// Manual Stealth Script
+				await addStealthScript(context);
+			}
 
 			const page = context.pages()[0] || (await context.newPage());
 
@@ -422,6 +459,7 @@ async function firefoxLauncher({ profilePath, proxy, timezoneId, maxWidth, human
 	// BRANCH B: PERSISTENT PROFILE (launchPersistentContext + Manual Script)
 	// ==================================================================
 	else {
+		// spoof_fingerprint not needed for isPersistent in firefox
 		try {
 			if (!fs.existsSync(activePath)) fs.mkdirSync(activePath, { recursive: true });
 
@@ -450,13 +488,34 @@ async function firefoxLauncher({ profilePath, proxy, timezoneId, maxWidth, human
 // ==========================================================================
 // 6. ENGINE: BRAVE
 // ==========================================================================
-async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, maxWidth, humanize_options }) {
+async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, maxWidth, humanize_options, spoof_fingerprint }) {
 	const isPersistent = !!profilePath;
 	const activePath = isPersistent ? profilePath : path.join(TEMP_DIR, crypto.randomUUID());
 
 	console.log(`🚀 Starting Brave: ${activePath}`);
 	fs.mkdirSync(activePath, { recursive: true });
 
+	// ======================================================
+	// Persist spoof_fingerprint setting for persistent profiles
+	// On first launch: save the setting. On subsequent launches: use saved value.
+	// ======================================================
+	let effectiveSpoofFingerprint = spoof_fingerprint;
+	const settingsFilePath = path.join(activePath, "settings.json");
+
+	if (isPersistent) {
+		if (fs.existsSync(settingsFilePath)) {
+			// 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: ${effectiveSpoofFingerprint} (ignoring current: ${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: ${spoof_fingerprint}`);
+		}
+	}
+
 	let fingerprintData;
 	const fingerprintFilePath = path.join(activePath, "fingerprint.json");
 
@@ -474,17 +533,42 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, maxWid
 
 	const braveBin = getBinaryPath("brave");
 
+	// ======================================================
+	// 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"));
+		}
+		// Set sidebar_show_option to 3 = Never show
+		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 args = [
 		"--test-type",
 		// --- Stealth & Anti-Detection ---
 		"--disable-blink-features=AutomationControlled",
 		//"--disable-features=UserAgentClientHint",
 
+		// --- Window Size ---
+		"--start-maximized",
+
 		// --- PREVENT EXTRA TABS (New Flags) ---
 		// "--no-startup-window",
 		"--homepage=about:blank",
 		"--disable-restore-session-state", // Prevents restoring old tabs
 
+
 		// --- Error Suppression ---
 		"--disable-session-crashed-bubble",
 		"--hide-crash-restore-bubble",
@@ -502,7 +586,7 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, maxWid
 		"--disable-client-side-phishing-detection",
 
 		// --- Brave Specific Silence ---
-		"--disable-features=Translate,BraveRewards,BraveWallet,BraveNews",
+		"--disable-features=Translate,BraveRewards,BraveWallet,BraveNews,Sidebar,SidePanel",
 		"--disable-infobars",
 	];
 	const ignoreDefaultArgs = ["--enable-automation", "--no-sandbox"];
@@ -514,19 +598,39 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, maxWid
 	const proxyObj = formatProxy(proxy);
 	const tz = timezoneId || undefined;
 
-	const context = await chromium.launchPersistentContext(activePath, {
-		headless: false,
-		executablePath: braveBin,
-		proxy: proxyObj,
-		timezoneId: tz,
-		ignoreDefaultArgs: ignoreDefaultArgs,
-		args: args,
-		userAgent: fingerprintData.fingerprint.navigator.userAgent,
-		viewport: fingerprintData.fingerprint.screen,
-		locale: fingerprintData.fingerprint.navigator.language,
-	});
 
-	await new FingerprintInjector().attachFingerprintToPlaywright(context, fingerprintData);
+	let context;
+	if (effectiveSpoofFingerprint) {
+		context = await chromium.launchPersistentContext(activePath, {
+			headless: false,
+			executablePath: braveBin,
+			proxy: proxyObj,
+			timezoneId: tz,
+			ignoreDefaultArgs: ignoreDefaultArgs,
+			args: args,
+			userAgent: fingerprintData.fingerprint.navigator.userAgent,
+			viewport: fingerprintData.fingerprint.screen,
+			locale: fingerprintData.fingerprint.navigator.language,
+		});
+
+		await new FingerprintInjector().attachFingerprintToPlaywright(context, fingerprintData);
+	}
+	else {
+		context = await chromium.launchPersistentContext(activePath, {
+			headless: false,
+			executablePath: braveBin,
+			proxy: proxyObj,
+			timezoneId: tz,
+			ignoreDefaultArgs: ignoreDefaultArgs,
+			args: args,
+			viewport: null,
+		});
+
+		// Manual Stealth Script
+		await addStealthScript(context);
+	}
+
+
 
 	// ======================================================
 	// 🛠️ FIX: Close Extra Tabs (Brave Dashboard / Restore)