arn-browser 0.0.14 → 0.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "arn-browser",
-	"version": "0.0.14",
+	"version": "0.1.0",
 	"description": "A lightweight, browser autmation helper.",
 	"main": "src/index.js",
 	"types": "src/index.d.ts",
@@ -11,7 +11,7 @@
 		"test": "test"
 	},
 	"dependencies": {
-		"@aws-sdk/client-ec2": "^3.946.0",
+		"@aws-sdk/client-ec2": "^3.953.0",
 		"@ghostery/adblocker": "^2.13.0",
 		"arn-knexjs": "^0.0.3",
 		"camoufox-js": "^0.8.4",

package/src/utility/launchBrowser.d.ts

@@ -174,24 +174,32 @@ export interface LaunchOptions {
 	CapSolver?: boolean;
 
 	/**
-	 * Maximum width constraint for fingerprint generation.
-	 * - If <= 10: Treated as multiplier of detected screen width (e.g. 1 = 100%, 0.8 = 80%).
-	 * - If > 10: Treated as specific pixel width.
-	 * Default: 1 (100% of detected screen width or 1920px fallback)
-	 */
-	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.
+	 * Configuration for browser fingerprint spoofing.
+	 * 
+	 * - `false`: No fingerprint spoofing (default)
+	 * - `true`: Spoof fingerprint with viewport: null (maximized window)
+	 * - `{ minWidth?, maxWidth?, minHeight?, maxHeight? }`: Spoof fingerprint with screen constraints
+	 *   and use the generated screen dimensions as viewport.
 	 * 
 	 * **For persistent Brave profiles:** The value is locked on first launch.
 	 * Subsequent launches will use the saved value, ignoring the current parameter.
 	 * 
+	 * @example
+	 * // Spoof with maximized window (viewport: null)
+	 * spoof_fingerprint: true
+	 * 
+	 * @example
+	 * // Spoof with specific screen constraints
+	 * spoof_fingerprint: { minWidth: 1366, maxWidth: 1920, minHeight: 768 }
+	 * 
 	 * Default: false
 	 */
-	spoof_fingerprint?: boolean;
+	spoof_fingerprint?: boolean | {
+		minWidth?: number;
+		maxWidth?: number;
+		minHeight?: number;
+		maxHeight?: number;
+	};
 
 	// ========================================================================
 	// 5. ENGINE SPECIFIC GROUPS

package/src/utility/launchBrowser.js

@@ -137,8 +137,10 @@ function cleanUpTempProfiles(ageLimitMinutes) {
 
 /**
  * Helper to generate consistent fingerprint options.
+ * @param {string} browserType - 'chromium' | 'firefox' | 'brave'
+ * @param {object|null} screenOptions - Optional screen constraints { minWidth, maxWidth, minHeight, maxHeight }
  */
-function getFingerprintConfig(browserType, maxWidth) {
+function getFingerprintConfig(browserType, screenOptions = null) {
 	const config = {
 		devices: ["desktop"],
 		operatingSystems: [detectedOs],
@@ -148,16 +150,19 @@ function getFingerprintConfig(browserType, maxWidth) {
 	};
 
 	if (browserType === "chromium") {
-		config.browsers.push({ name: "chrome", minVersion: 140 });
+		config.browsers.push({ name: "chrome", minVersion: 141 });
 	} else if (browserType === "firefox") {
-		config.browsers.push({ name: "firefox", minVersion: 140 });
+		config.browsers.push({ name: "firefox", minVersion: 141 });
 	} else if (browserType === "brave") {
-		config.browsers.push({ name: "chrome", minVersion: 140 });
+		config.browsers.push({ name: "chrome", minVersion: 141 });
 	}
 
-	if (maxWidth) {
-		const widthVal = maxWidth <= 10 ? Math.round(maxWidth * 1920) : maxWidth;
-		config.screen.maxWidth = widthVal;
+	// Apply screen filter options if provided
+	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;
@@ -171,7 +176,6 @@ export async function launchBrowser({
 	// Common
 	timezoneId = null,
 	proxy,
-	maxWidth = 1,
 
 	// Path & Storage
 	profile_path = null,
@@ -183,6 +187,9 @@ export async function launchBrowser({
 	humanize_options = {}, // { humanize, maxTime, minTime, showCursor } - defaults to enabled for non-camoufox
 
 	// Spoof Fingerprint
+	// - false: No spoofing
+	// - true: Spoof fingerprint with viewport: null (no screen constraint)
+	// - { minWidth?, maxWidth?, minHeight?, maxHeight? }: Spoof with screen constraints
 	spoof_fingerprint = false,
 
 	// Browser Specific Grouped Options
@@ -214,7 +221,6 @@ export async function launchBrowser({
 					proxy,
 					timezoneId,
 					CapSolver,
-					maxWidth,
 					humanize_options: effectiveHumanizeOptions,
 					spoof_fingerprint,
 				});
@@ -224,7 +230,6 @@ export async function launchBrowser({
 					profilePath: fullPath,
 					proxy,
 					timezoneId,
-					maxWidth,
 					humanize_options: effectiveHumanizeOptions,
 					spoof_fingerprint,
 				});
@@ -236,7 +241,6 @@ export async function launchBrowser({
 					proxy,
 					timezoneId,
 					CapSolver,
-					maxWidth,
 					humanize_options: effectiveHumanizeOptions,
 					spoof_fingerprint,
 				});
@@ -247,7 +251,6 @@ export async function launchBrowser({
 					profilePath: fullPath,
 					proxy,
 					timezoneId,
-					maxWidth,
 					camoufox_options,
 					// Spoof Fingerprint not needed for Camoufox
 				});
@@ -274,9 +277,7 @@ export async function launchBrowser({
 // ==========================================================================
 // 4. ENGINE: CHROMIUM
 // ==========================================================================
-async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, maxWidth, humanize_options
-	, spoof_fingerprint
-}) {
+async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, humanize_options, spoof_fingerprint }) {
 	const isPersistent = !!profilePath;
 
 	// 1. Determine Path (Temp needs it for fingerprint storage, Persistent needs it for data)
@@ -324,12 +325,15 @@ async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, max
 	const proxyObj = formatProxy(proxy);
 	const tz = timezoneId || undefined;
 
+	// Determine screen options from spoof_fingerprint if it's an object
+	const screenOptions = (spoof_fingerprint && typeof spoof_fingerprint === 'object') ? spoof_fingerprint : null;
+
 	// ==================================================================
 	// BRANCH A: TEMP PROFILE (launch + newInjectedContext)
 	// ==================================================================
 	if (!isPersistent) {
 		try {
-			const fpConfig = getFingerprintConfig("chromium", maxWidth);
+			const fpConfig = getFingerprintConfig("chromium", screenOptions);
 			const fingerprintData = new FingerprintGenerator().getFingerprint(fpConfig);
 
 			// Launch standard browser (not persistent context)
@@ -350,6 +354,7 @@ async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, max
 			} else {
 				context = await browser.newContext({
 					timezoneId: tz,
+					viewport: null,
 				});
 				// Manual Stealth Script
 				await addStealthScript(context);
@@ -398,7 +403,7 @@ async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, max
 // ==========================================================================
 // 5. ENGINE: FIREFOX
 // ==========================================================================
-async function firefoxLauncher({ profilePath, proxy, timezoneId, maxWidth, humanize_options, spoof_fingerprint }) {
+async function firefoxLauncher({ profilePath, proxy, timezoneId, humanize_options, spoof_fingerprint }) {
 	const isPersistent = !!profilePath;
 
 	// 1. Determine Path
@@ -408,6 +413,9 @@ async function firefoxLauncher({ profilePath, proxy, timezoneId, maxWidth, human
 	const proxyObj = formatProxy(proxy);
 	const tz = timezoneId || undefined;
 
+	// Determine screen options from spoof_fingerprint if it's an object
+	const screenOptions = (spoof_fingerprint && typeof spoof_fingerprint === 'object') ? spoof_fingerprint : null;
+
 	// Firefox specific preferences
 	const firefoxUserPrefs = {
 		"dom.webdriver.enabled": false,
@@ -420,7 +428,7 @@ async function firefoxLauncher({ profilePath, proxy, timezoneId, maxWidth, human
 	// ==================================================================
 	if (!isPersistent) {
 		try {
-			const fpConfig = getFingerprintConfig("firefox", maxWidth);
+			const fpConfig = getFingerprintConfig("firefox", screenOptions);
 			const fingerprintData = new FingerprintGenerator().getFingerprint(fpConfig);
 
 			const browser = await firefox.launch({
@@ -441,6 +449,7 @@ async function firefoxLauncher({ profilePath, proxy, timezoneId, maxWidth, human
 			else {
 				context = await browser.newContext({
 					timezoneId: tz,
+					viewport: null,
 				});
 				// Manual Stealth Script
 				await addStealthScript(context);
@@ -488,7 +497,7 @@ async function firefoxLauncher({ profilePath, proxy, timezoneId, maxWidth, human
 // ==========================================================================
 // 6. ENGINE: BRAVE
 // ==========================================================================
-async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, maxWidth, humanize_options, spoof_fingerprint }) {
+async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, humanize_options, spoof_fingerprint }) {
 	const isPersistent = !!profilePath;
 	const activePath = isPersistent ? profilePath : path.join(TEMP_DIR, crypto.randomUUID());
 
@@ -507,22 +516,31 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, maxWid
 			// 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})`);
+			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: ${spoof_fingerprint}`);
+			console.log(`📝 Saved spoof_fingerprint setting: ${JSON.stringify(spoof_fingerprint)}`);
 		}
 	}
 
+	// Determine screen options from spoof_fingerprint if it's an object
+	const screenOptions = (effectiveSpoofFingerprint && typeof effectiveSpoofFingerprint === 'object') ? effectiveSpoofFingerprint : null;
+
+	// Determine if we should use screen viewport or null
+	// - spoof_fingerprint = true (boolean) -> spoof with viewport: null
+	// - spoof_fingerprint = { minWidth, maxWidth, ... } (object) -> spoof with generated screen viewport
+	const useScreenViewport = screenOptions !== null;
+
 	let fingerprintData;
 	const fingerprintFilePath = path.join(activePath, "fingerprint.json");
 
 	if (fs.existsSync(fingerprintFilePath)) {
 		fingerprintData = JSON.parse(fs.readFileSync(fingerprintFilePath, "utf-8"));
 	} else {
-		const fpConfig = getFingerprintConfig("brave", maxWidth);
+		// Generate fingerprint with screen options (null if spoof_fingerprint is just true)
+		const fpConfig = getFingerprintConfig("brave", screenOptions);
 		fingerprintData = new FingerprintGenerator().getFingerprint(fpConfig);
 
 		if (isPersistent) {
@@ -601,6 +619,9 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, maxWid
 
 	let context;
 	if (effectiveSpoofFingerprint) {
+		// Determine viewport: use screen from fingerprint if object provided, otherwise null
+		const viewport = useScreenViewport ? fingerprintData.fingerprint.screen : null;
+
 		context = await chromium.launchPersistentContext(activePath, {
 			headless: false,
 			executablePath: braveBin,
@@ -609,7 +630,9 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, maxWid
 			ignoreDefaultArgs: ignoreDefaultArgs,
 			args: args,
 			userAgent: fingerprintData.fingerprint.navigator.userAgent,
-			viewport: fingerprintData.fingerprint.screen,
+			// viewport: viewport,
+			// For Brave browser viewport set not working
+			viewport: null,
 			locale: fingerprintData.fingerprint.navigator.language,
 		});
 
@@ -653,7 +676,7 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, maxWid
 // ==========================================================================
 // 7. ENGINE: CAMOUFOX
 // ==========================================================================
-async function camoufoxLauncher({ profilePath, proxy, timezoneId, maxWidth, camoufox_options = {} }) {
+async function camoufoxLauncher({ profilePath, proxy, timezoneId, camoufox_options = {} }) {
 	const isPersistent = !!profilePath;
 	const activePath = isPersistent ? profilePath : path.join(TEMP_DIR, crypto.randomUUID());
 
@@ -686,7 +709,6 @@ async function camoufoxLauncher({ profilePath, proxy, timezoneId, maxWidth, camo
 			const randomIndex = Math.floor(Math.random() * validMajorVersions.length);
 			return validMajorVersions[randomIndex];
 		}
-		const screenWidth = maxWidth ? (maxWidth <= 10 ? Math.round(maxWidth * 1920) : maxWidth) : 1920;
 
 		// Prepare the base options
 		const optionsGenerator = {
@@ -704,12 +726,9 @@ async function camoufoxLauncher({ profilePath, proxy, timezoneId, maxWidth, camo
 			...camoufox_options, // Spread user overrides
 		};
 
+		// Use screen from camoufox_options if provided
 		if (camoufox_options.screen) {
 			optionsGenerator.screen = camoufox_options.screen;
-		} else {
-			optionsGenerator.screen = {
-				maxWidth: screenWidth,
-			};
 		}
 		// If GeoIP is TRUE, pass proxy inside launchOptions
 		if (isGeoIpEnabled && proxyObj) {