arn-browser 0.1.32 → 0.1.33

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "arn-browser",
-	"version": "0.1.32",
+	"version": "0.1.33",
 	"description": "A lightweight, browser autmation helper.",
 	"main": "src/index.js",
 	"types": "src/index.d.ts",
@@ -20,14 +20,14 @@
 		"dotenv": "^17.2.3",
 		"fingerprint-generator": "^2.1.78",
 		"fingerprint-injector": "^2.1.78",
-		"https-proxy-agent": "^8.0.0",
+		"https-proxy-agent": "^9.0.0",
 		"node-cache": "^5.1.2",
 		"node-fetch": "^3.3.2",
 		"playwright-core": "1.42.1",
 		"proxy-chain": "^2.6.0",
 		"puppeteer-core": "^24.40.0",
 		"randomstring": "^1.3.1",
-		"socks-proxy-agent": "^9.0.0",
+		"socks-proxy-agent": "^10.0.0",
 		"speakeasy": "^2.0.0",
 		"superagent": "^10.2.3"
 	},

package/src/utility/playwright/pwLaunch.d.ts

@@ -268,7 +268,24 @@ export interface PwLaunchOptions {
 	humanize_options?: HumanizeOptions;
 
 	// ========================================================================
-	// 6. LOGGING
+	// 6. NOTIFICATIONS
+	// ========================================================================
+
+	/**
+	 * List of hostnames to auto-grant notification permissions for.
+	 * Pass plain hostnames — they are auto-converted to `https://host:443` internally.
+	 *
+	 * If empty (default), Chrome's default "Ask" behavior is used.
+	 *
+	 * @example
+	 * notification_hosts: ["web.whatsapp.com", "messages.google.com"]
+	 *
+	 * Default: []
+	 */
+	notification_hosts?: string[];
+
+	// ========================================================================
+	// 7. LOGGING
 	// ========================================================================
 
 	/**

package/src/utility/playwright/pwLaunch.js

@@ -71,7 +71,8 @@ function resolveProfilePath(nameOrPath, browserName) {
 
 	let prefix = browserName.toLowerCase();
 	if (prefix.includes("brave")) prefix = "brave";
-	else if (prefix.includes("chrome") || prefix.includes("chromium")) prefix = "chromium";
+	else if (prefix.includes("chromium")) prefix = "chromium";
+	else if (prefix.includes("chrome")) prefix = "chrome";
 	else if (prefix.includes("firefox")) prefix = "firefox";
 	else if (prefix.includes("camoufox")) prefix = "camoufox";
 
@@ -114,6 +115,31 @@ function writeProfileMeta(dirPath, type, cleanupMinutes) {
 	}
 }
 
+/**
+ * Writes per-host notification permissions into the Chrome Preferences object.
+ * Accepts plain hostnames (e.g. "web.whatsapp.com") and converts them
+ * to Chrome's internal format: "https://host:443,*" with setting=1 (Allow).
+ * If hosts array is empty, does nothing (Chrome default "Ask" behavior).
+ */
+function writeNotificationPermissions(prefs, hosts) {
+	if (!hosts || hosts.length === 0) return;
+
+	if (!prefs.profile) prefs.profile = {};
+	if (!prefs.profile.content_settings) prefs.profile.content_settings = {};
+	if (!prefs.profile.content_settings.exceptions) prefs.profile.content_settings.exceptions = {};
+	if (!prefs.profile.content_settings.exceptions.notifications) prefs.profile.content_settings.exceptions.notifications = {};
+
+	const now = String(Date.now());
+	for (const host of hosts) {
+		const origin = host.startsWith("http") ? host : `https://${host}:443`;
+		const key = `${origin},*`;
+		prefs.profile.content_settings.exceptions.notifications[key] = {
+			last_modified: now,
+			setting: 1, // 1 = Allow
+		};
+	}
+}
+
 /**
  * Scans both persistent and temp profile directories.
  * Deletes profiles whose `_profile_meta.json` indicates they are expired.
@@ -278,6 +304,10 @@ export async function pwLaunch({
 	camoufox_options = {}, // { geoip, humanize, ... }
 	multilogin_options = {}, // { profileId, os_type, canvas_noise, ... }
 
+	// Notifications — per-host allow list
+	// Pass plain hostnames: ["web.whatsapp.com", "messages.google.com"]
+	notification_hosts = [],
+
 	// Logging
 	launch_logs = false,
 	cleanup_logs = false,
@@ -325,6 +355,7 @@ export async function pwLaunch({
 					spoof_fingerprint,
 					cleanupMinutes: effectiveCleanupMinutes,
 					browserType: which_browser, // "chrome" or "chromium"
+					notification_hosts,
 				});
 				break;
 			case "firefox":
@@ -347,6 +378,7 @@ export async function pwLaunch({
 					humanize_options: effectiveHumanizeOptions,
 					spoof_fingerprint,
 					cleanupMinutes: effectiveCleanupMinutes,
+					notification_hosts,
 				});
 				break;
 			case "camoufox":
@@ -382,7 +414,7 @@ export async function pwLaunch({
 // ==========================================================================
 // 4. ENGINE: CHROMIUM
 // ==========================================================================
-async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, humanize_options, spoof_fingerprint, cleanupMinutes, browserType = "chromium" }) {
+async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, humanize_options, spoof_fingerprint, cleanupMinutes, browserType = "chromium", notification_hosts = [] }) {
 	const isPersistent = !!profilePath;
 
 	// 1. Determine Path (Temp needs it for fingerprint storage, Persistent needs it for data)
@@ -411,6 +443,8 @@ async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, hum
 		// --- Silence & Networking ---
 		"--disable-background-networking",
 		"--disable-background-timer-throttling",
+		"--disable-backgrounding-occluded-windows",
+		"--disable-renderer-backgrounding",
 		"--disable-breakpad",
 		"--disable-crash-reporter",
 		"--disable-component-update",
@@ -498,6 +532,7 @@ async function chromiumLauncher({ profilePath, proxy, timezoneId, CapSolver, hum
 
 				if (!prefs.profile) prefs.profile = {};
 				prefs.profile.exit_type = "Normal";
+				writeNotificationPermissions(prefs, notification_hosts);
 
 				if (!prefs.session) prefs.session = {};
 				prefs.session.restore_on_startup = 4;
@@ -631,7 +666,7 @@ async function firefoxLauncher({ profilePath, proxy, timezoneId, humanize_option
 // ==========================================================================
 // 6. ENGINE: BRAVE
 // ==========================================================================
-async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, humanize_options, spoof_fingerprint, cleanupMinutes }) {
+async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, humanize_options, spoof_fingerprint, cleanupMinutes, notification_hosts = [] }) {
 	const isPersistent = !!profilePath;
 	const activePath = isPersistent ? profilePath : path.join(TEMP_DIR, crypto.randomUUID());
 
@@ -706,6 +741,7 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, humani
 		// Prevent tab restore (saves proxy bandwidth)
 		if (!prefs.profile) prefs.profile = {};
 		prefs.profile.exit_type = "Normal";
+		writeNotificationPermissions(prefs, notification_hosts);
 
 		if (!prefs.session) prefs.session = {};
 		prefs.session.restore_on_startup = 4;
@@ -759,6 +795,8 @@ async function braveLauncher({ profilePath, proxy, CapSolver, timezoneId, humani
 		// --- Silence & Networking ---
 		"--disable-background-networking",
 		"--disable-background-timer-throttling",
+		"--disable-backgrounding-occluded-windows",
+		"--disable-renderer-backgrounding",
 		"--disable-breakpad",
 		"--disable-crash-reporter",
 		"--disable-component-update",

package/src/utility/puppeteer/ppLaunch.d.ts

@@ -180,7 +180,24 @@ export interface PpLaunchOptions {
 	};
 
 	// ========================================================================
-	// 8. LOGGING
+	// 8. NOTIFICATIONS
+	// ========================================================================
+
+	/**
+	 * List of hostnames to auto-grant notification permissions for.
+	 * Pass plain hostnames — they are auto-converted to `https://host:443` internally.
+	 *
+	 * If empty (default), Chrome's default "Ask" behavior is used.
+	 *
+	 * @example
+	 * notification_hosts: ["web.whatsapp.com", "messages.google.com"]
+	 *
+	 * Default: []
+	 */
+	notification_hosts?: string[];
+
+	// ========================================================================
+	// 9. LOGGING
 	// ========================================================================
 
 	/**

package/src/utility/puppeteer/ppLaunch.js

@@ -128,7 +128,8 @@ function resolveProfilePath(nameOrPath, browserName) {
 
 	let prefix = browserName.toLowerCase();
 	if (prefix.includes("brave")) prefix = "brave";
-	else if (prefix.includes("chrome") || prefix.includes("chromium")) prefix = "chrome";
+	else if (prefix.includes("chromium")) prefix = "chromium";
+	else if (prefix.includes("chrome")) prefix = "chrome";
 
 	const folderName = `${prefix}_${nameOrPath}`;
 	return path.join(PERSISTENT_DIR, folderName);
@@ -163,6 +164,31 @@ function writeProfileMeta(dirPath, type, cleanupMinutes) {
 	}
 }
 
+/**
+ * Writes per-host notification permissions into the Chrome Preferences object.
+ * Accepts plain hostnames (e.g. "web.whatsapp.com") and converts them
+ * to Chrome's internal format: "https://host:443,*" with setting=1 (Allow).
+ * If hosts array is empty, does nothing (Chrome default "Ask" behavior).
+ */
+function writeNotificationPermissions(prefs, hosts) {
+	if (!hosts || hosts.length === 0) return;
+
+	if (!prefs.profile) prefs.profile = {};
+	if (!prefs.profile.content_settings) prefs.profile.content_settings = {};
+	if (!prefs.profile.content_settings.exceptions) prefs.profile.content_settings.exceptions = {};
+	if (!prefs.profile.content_settings.exceptions.notifications) prefs.profile.content_settings.exceptions.notifications = {};
+
+	const now = String(Date.now());
+	for (const host of hosts) {
+		const origin = host.startsWith("http") ? host : `https://${host}:443`;
+		const key = `${origin},*`;
+		prefs.profile.content_settings.exceptions.notifications[key] = {
+			last_modified: now,
+			setting: 1, // 1 = Allow
+		};
+	}
+}
+
 /**
  * Scans profile directories and deletes expired profiles.
  */
@@ -262,6 +288,10 @@ export async function ppLaunch({
 	// Multilogin
 	multilogin_options = {},
 
+	// Notifications — per-host allow list
+	// Pass plain hostnames: ["web.whatsapp.com", "messages.google.com"]
+	notification_hosts = [],
+
 	// Logging
 	launch_logs = false,
 	cleanup_logs = false,
@@ -295,6 +325,7 @@ export async function ppLaunch({
 					spoof_fingerprint,
 					cleanupMinutes: effectiveCleanupMinutes,
 					browserType: "chrome",
+					notification_hosts,
 				});
 				break;
 			case "chromium":
@@ -306,6 +337,7 @@ export async function ppLaunch({
 					spoof_fingerprint,
 					cleanupMinutes: effectiveCleanupMinutes,
 					browserType: "chromium",
+					notification_hosts,
 				});
 				break;
 			case "brave":
@@ -316,6 +348,7 @@ export async function ppLaunch({
 					extraArgs,
 					spoof_fingerprint,
 					cleanupMinutes: effectiveCleanupMinutes,
+					notification_hosts,
 				});
 				break;
 			case "multilogin":
@@ -339,7 +372,7 @@ export async function ppLaunch({
 // 4. ENGINE: CHROME (CDP)
 // ==========================================================================
 
-async function chromeLauncher({ profilePath, proxy, timezoneId, extraArgs, spoof_fingerprint, cleanupMinutes, browserType = "chrome" }) {
+async function chromeLauncher({ profilePath, proxy, timezoneId, extraArgs, spoof_fingerprint, cleanupMinutes, browserType = "chrome", notification_hosts = [] }) {
 	const isPersistent = !!profilePath;
 	const activePath = isPersistent ? profilePath : path.join(TEMP_DIR, crypto.randomUUID());
 
@@ -357,6 +390,7 @@ async function chromeLauncher({ profilePath, proxy, timezoneId, extraArgs, spoof
 		extraArgs,
 		spoof_fingerprint,
 		browserLabel: browserType === "chromium" ? "Chromium" : "Chrome",
+		notification_hosts,
 	});
 }
 
@@ -364,7 +398,7 @@ async function chromeLauncher({ profilePath, proxy, timezoneId, extraArgs, spoof
 // 5. ENGINE: BRAVE (CDP)
 // ==========================================================================
 
-async function braveLauncher({ profilePath, proxy, timezoneId, extraArgs, spoof_fingerprint, cleanupMinutes }) {
+async function braveLauncher({ profilePath, proxy, timezoneId, extraArgs, spoof_fingerprint, cleanupMinutes, notification_hosts = [] }) {
 	const isPersistent = !!profilePath;
 	const activePath = isPersistent ? profilePath : path.join(TEMP_DIR, crypto.randomUUID());
 
@@ -391,6 +425,7 @@ async function braveLauncher({ profilePath, proxy, timezoneId, extraArgs, spoof_
 		// Prevent tab restore (saves proxy bandwidth)
 		if (!prefs.profile) prefs.profile = {};
 		prefs.profile.exit_type = "Normal";
+		writeNotificationPermissions(prefs, notification_hosts);
 
 		if (!prefs.session) prefs.session = {};
 		prefs.session.restore_on_startup = 4;
@@ -438,6 +473,7 @@ async function braveLauncher({ profilePath, proxy, timezoneId, extraArgs, spoof_
 		extraArgs: [...braveArgs, ...extraArgs],
 		spoof_fingerprint,
 		browserLabel: "Brave",
+		notification_hosts,
 	});
 }
 
@@ -445,7 +481,7 @@ async function braveLauncher({ profilePath, proxy, timezoneId, extraArgs, spoof_
 // 6. CDP SPAWN & CONNECT (Shared between Chrome & Brave)
 // ==========================================================================
 
-async function spawnAndConnect({ binaryPath, profilePath, isPersistent, proxy, timezoneId = null, extraArgs = [], spoof_fingerprint = false, browserLabel = "Browser" }) {
+async function spawnAndConnect({ binaryPath, profilePath, isPersistent, proxy, timezoneId = null, extraArgs = [], spoof_fingerprint = false, browserLabel = "Browser", notification_hosts = [] }) {
 	let browser;
 	let closing = false;
 	let signalHandler;
@@ -468,6 +504,7 @@ async function spawnAndConnect({ binaryPath, profilePath, isPersistent, proxy, t
 		// Prevent "Restore pages?" prompt after crash
 		if (!prefs.profile) prefs.profile = {};
 		prefs.profile.exit_type = "Normal";
+		writeNotificationPermissions(prefs, notification_hosts);
 
 		// Set startup to open about:blank instead of restoring tabs
 		if (!prefs.session) prefs.session = {};
@@ -508,6 +545,8 @@ async function spawnAndConnect({ binaryPath, profilePath, isPersistent, proxy, t
 		// --- Silence & Networking ---
 		"--disable-background-networking",
 		"--disable-background-timer-throttling",
+		"--disable-backgrounding-occluded-windows",
+		"--disable-renderer-backgrounding",
 		"--disable-breakpad",
 		"--disable-crash-reporter",
 		"--disable-component-update",