arn-browser 0.1.11 → 0.1.13

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "arn-browser",
-	"version": "0.1.11",
+	"version": "0.1.13",
 	"description": "A lightweight, browser autmation helper.",
 	"main": "src/index.js",
 	"types": "src/index.d.ts",
@@ -22,7 +22,7 @@
 		"https-proxy-agent": "^7.0.6",
 		"node-cache": "^5.1.2",
 		"node-fetch": "^3.3.2",
-		"playwright": "^1.42.1",
+		"playwright-core": "1.42.1",
 		"proxy-chain": "^2.6.0",
 		"puppeteer-core": "^24.38.0",
 		"randomstring": "^1.3.1",

package/src/index.d.ts

@@ -4,7 +4,8 @@ import { ppLaunch } from "./utility/puppeteer/ppLaunch";
 import { ppRoute, ppCacheLogs } from "./utility/puppeteer/routes/ppRoute";
 import { pwLaunch } from "./utility/playwright/pwLaunch";
 import { pwRoute, pwCacheLogs } from "./utility/playwright/routes/pwRoute";
-import { retryNavigation, retryClick, checkPageConditions } from "./utility/playwright/playwright-helper";
+import { retryNavigation, retryClick, checkPageConditions } from "./utility/playwright/pwHelper";
+import { retryNavigation as ppRetryNavigation } from "./utility/puppeteer/ppHelper";
 import { startProxyServer, fetchPublicIP, fetchProxyDetails } from "./utility/proxy-utility/proxy-chain";
 import {
     fetchAwsProxy, getInstanceStatus, getPublicIpAddress,
@@ -20,6 +21,7 @@ export declare const ppBrowser: {
     launch: typeof ppLaunch;
     route: typeof ppRoute;
     cacheLogs: typeof ppCacheLogs;
+    ppGoto: typeof ppRetryNavigation;
 };
 
 export declare const pwBrowser: {
@@ -31,7 +33,7 @@ export declare const pwBrowser: {
     pwConditions: typeof checkPageConditions;
 };
 
-export declare const proxy: {
+export declare const proxyUtil: {
     startServer: typeof startProxyServer;
     fetchPublicIP: typeof fetchPublicIP;
     fetchDetails: typeof fetchProxyDetails;

package/src/index.js

@@ -5,17 +5,19 @@
 // --- Puppeteer ---
 import { ppLaunch } from "./utility/puppeteer/ppLaunch.js";
 import { ppRoute, ppCacheLogs } from "./utility/puppeteer/routes/ppRoute.js";
+import { retryNavigation as ppRetryNavigation } from "./utility/puppeteer/ppHelper.js";
 
 export const ppBrowser = {
 	launch: ppLaunch,
 	route: ppRoute,
 	cacheLogs: ppCacheLogs,
+	ppGoto: ppRetryNavigation,
 };
 
 // --- Playwright ---
 import { pwLaunch } from "./utility/playwright/pwLaunch.js";
 import { pwRoute, pwCacheLogs } from "./utility/playwright/routes/pwRoute.js";
-import { retryNavigation, retryClick, checkPageConditions } from "./utility/playwright/playwright-helper.js";
+import { retryNavigation, retryClick, checkPageConditions } from "./utility/playwright/pwHelper.js";
 
 export const pwBrowser = {
 	launch: pwLaunch,
@@ -45,7 +47,7 @@ import {
 } from "./utility/proxy-utility/custom-proxy.js";
 import { get_multilogin_proxy, get_packetstream_proxy, get_x_proxy, fetchNextProxy } from "./utility/proxy-utility/proxy-helper.js";
 
-export const proxy = {
+export const proxyUtil = {
 	startServer: startProxyServer,
 	fetchPublicIP,
 	fetchDetails: fetchProxyDetails,

package/src/utility/playwright/human-cursor/HumanCursor.js

@@ -273,9 +273,9 @@ function createHumanLocator(cursor, locator) {
  * Create a HumanCursor that acts as a drop-in replacement for Page
  * All page methods work, but click/fill/type/check/hover use human cursor
  * 
- * @param {import('playwright').Page} page - Playwright Page object
+ * @param {import('playwright-core').Page} page - Playwright Page object
  * @param {Object} options - Configuration options
- * @returns {import('playwright').Page & HumanCursorMethods}
+ * @returns {import('playwright-core').Page & HumanCursorMethods}
  */
 export function createCursor(page, options = {}) {
     const config = {

package/src/utility/playwright/human-cursor/index.d.ts

@@ -2,7 +2,7 @@
  * TypeScript declarations for human-cursor-playwright
  */
 
-import type { Page, Locator, Response, PageScreenshotOptions, WaitForURLOptions } from 'playwright';
+import type { Page, Locator, Response, PageScreenshotOptions, WaitForURLOptions } from 'playwright-core';
 
 // ============= Tweening Functions =============
 

package/src/utility/playwright/{playwright-helper.d.ts → pwHelper.d.ts}

@@ -1,4 +1,4 @@
-import { Page, Locator } from "playwright";
+import { Page, Locator } from "playwright-core";
 
 /**
  * Options for the retryNavigation function.

package/src/utility/playwright/{playwright-helper.js → pwHelper.js}

@@ -3,7 +3,7 @@
  * If navigation fails, it temporarily goes to "about:blank" before retrying.
  *
  * @param {Object} options
- * @param {import('playwright').Page} options.page - Playwright Page object
+ * @param {import('playwright-core').Page} options.page - Playwright Page object
  * @param {string} options.url - Target URL
  * @param {number} [options.maxRetries=5] - Maximum number of attempts
  * @param {string|null} [options.referer=null] - Referer header
@@ -54,7 +54,7 @@ export const retryNavigation = async ({
  * EXPECTATION: The element should disappear (become hidden) after clicking.
  *
  * @param {Object} options
- * @param {import('playwright').Locator} options.locator - The element to click
+ * @param {import('playwright-core').Locator} options.locator - The element to click
  * @param {number} [options.maxRetries=3] - Max retries
  * @param {number} [options.timeout=15000] - Timeout for visibility checks
  */
@@ -80,8 +80,8 @@ export const retryClick = async ({ locator, maxRetries = 3, timeout = 15000 }) =
  * Races multiple conditions (URL or Element) to see which happens first.
  * Modifies the input object by deleting the matched key.
  *
- * @param {import('playwright').Page} page
- * @param {Object.<string, string|import('playwright').Locator|null>} checksToPerform - Map of names to URL strings or Locators
+ * @param {import('playwright-core').Page} page
+ * @param {Object.<string, string|import('playwright-core').Locator|null>} checksToPerform - Map of names to URL strings or Locators
  * @param {number} timeout - Timeout in ms
  * @returns {Promise<string|null>} The key of the matched condition
  */

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

@@ -1,4 +1,4 @@
-import { Browser, BrowserContext, Page } from "playwright";
+import { Browser, BrowserContext, Page } from "playwright-core";
 import type { FingerprintGeneratorOptions } from "fingerprint-generator";
 import type { HumanPage, CreateCursorOptions } from "./human-cursor/index";
 type Screen = FingerprintGeneratorOptions["screen"];

package/src/utility/playwright/pwLaunch.js

@@ -9,7 +9,7 @@ import fs from "fs";
 import path from "path";
 import os from "os";
 import crypto from "node:crypto";
-import { chromium, firefox } from "playwright";
+import { chromium, firefox } from "playwright-core";
 import { setTimeout as sleep } from "timers/promises";
 
 // Fingerprint management
@@ -966,11 +966,27 @@ async function launchExistingMultiloginProfile(profileId, humanize_options = nul
 			page = createCursor(page, humanize_options);
 		}
 
+		let closing = false;
 		const closeBrowser = async () => {
+			if (closing) return false;
+			closing = true;
+			if (signalHandler) {
+				process.off("SIGINT", signalHandler);
+				process.off("SIGTERM", signalHandler);
+				process.off("SIGHUP", signalHandler);
+			}
 			if (browser) await browser.close().catch(() => { });
 			return await stopMultiloginProfile(profileId);
 		};
 
+		let signalHandler = async () => {
+			await closeBrowser();
+			process.exit(0);
+		};
+		process.once("SIGINT", signalHandler);
+		process.once("SIGTERM", signalHandler);
+		process.once("SIGHUP", signalHandler);
+
 		return { browser, context, page, isBrowserRunning: () => !!browser, closeBrowser, launchError: null };
 	} catch (error) {
 		console.error("Multilogin Launch Error:", error.message);
@@ -1040,11 +1056,27 @@ async function launchQuickMultiloginProfile({ os_type, proxy, canvas_noise, medi
 			page = createCursor(page, humanize_options);
 		}
 
+		let closing = false;
 		const closeBrowser = async () => {
+			if (closing) return false;
+			closing = true;
+			if (signalHandler) {
+				process.off("SIGINT", signalHandler);
+				process.off("SIGTERM", signalHandler);
+				process.off("SIGHUP", signalHandler);
+			}
 			if (browser) await browser.close().catch(() => { });
 			return await stopMultiloginProfile(profileId);
 		};
 
+		let signalHandler = async () => {
+			await closeBrowser();
+			process.exit(0);
+		};
+		process.once("SIGINT", signalHandler);
+		process.once("SIGTERM", signalHandler);
+		process.once("SIGHUP", signalHandler);
+
 		return { browser, context, page, isBrowserRunning: () => !!browser, closeBrowser, launchError: null };
 	} catch (error) {
 		console.error("Quick Profile Error:", error);

package/src/utility/playwright/routes/pwRoute.d.ts

@@ -1,4 +1,4 @@
-import { Browser, BrowserContext, Page } from "playwright";
+import { Browser, BrowserContext, Page } from "playwright-core";
 
 // ============================================================================
 // ROUTING & CACHE TYPES

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

@@ -0,0 +1,26 @@
+import { Page } from "puppeteer-core";
+
+/**
+ * Options for the retryNavigation function.
+ */
+export interface RetryNavigationOptions {
+	/** The Puppeteer Page object. */
+	page: Page;
+	/** The target URL to navigate to. */
+	url: string;
+	/** Maximum number of retry attempts. Default: 5 */
+	maxRetries?: number;
+	/** Custom Referer header. Default: null */
+	referer?: string | null;
+	/** Base timeout in milliseconds. Default: 30000 */
+	timeout?: number;
+	/** When to consider operation succeeded. Default: "load" */
+	waitUntil?: "load" | "domcontentloaded" | "networkidle0" | "networkidle2";
+}
+
+/**
+ * Navigates to a URL with retry logic and incremental timeouts.
+ * If navigation fails, it temporarily goes to "about:blank" before retrying.
+ * @returns True if navigation succeeded, throws error otherwise.
+ */
+export function retryNavigation(options: RetryNavigationOptions): Promise<boolean>;

package/src/utility/puppeteer/ppHelper.js

@@ -0,0 +1,48 @@
+/**
+ * Navigates to a URL with retry logic and incremental timeouts.
+ * If navigation fails, it temporarily goes to "about:blank" before retrying.
+ *
+ * @param {Object} options
+ * @param {import('puppeteer-core').Page} options.page - Puppeteer Page object
+ * @param {string} options.url - Target URL
+ * @param {number} [options.maxRetries=5] - Maximum number of attempts
+ * @param {string|null} [options.referer=null] - Referer header
+ * @param {number} [options.timeout=30000] - Base timeout in ms
+ * @param {"load"|"domcontentloaded"|"networkidle0"|"networkidle2"} [options.waitUntil="load"] - Wait condition
+ * @returns {Promise<boolean>} True if successful
+ */
+export const retryNavigation = async ({
+	page,
+	url,
+	maxRetries = 5,
+	referer = null,
+	timeout = 30000,
+	waitUntil = "load",
+}) => {
+	for (let retryCount = 0; retryCount < maxRetries; retryCount++) {
+		// Apply incremental timeout only if the initial timeout is <= 30,000
+		const currentTimeout = timeout <= 30000 ? timeout + retryCount * 15000 : timeout;
+		try {
+			const gotoOptions = {
+				waitUntil: waitUntil,
+				timeout: currentTimeout,
+			};
+
+			if (referer) {
+				gotoOptions.referer = referer;
+			}
+
+			await page.goto(url, gotoOptions);
+
+			return true;
+		} catch (error) {
+			console.log(`Navigation attempt ${retryCount + 1} failed.`, url);
+			await page.goto("about:blank", { waitUntil: "load", timeout: timeout });
+			if (retryCount === maxRetries - 1) {
+				console.log("All retry attempts failed");
+				throw error;
+			}
+		}
+	}
+	return false;
+};

package/src/utility/puppeteer/ppLaunch.js

@@ -612,13 +612,29 @@ async function launchExistingMultiloginProfile(profileId) {
 		const pages = await browser.pages();
 		const page = pages[0] ?? (await browser.newPage());
 
+		let closing = false;
 		const closeBrowser = 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 { }
 			return await stopMultiloginProfile(profileId);
 		};
 
+		let signalHandler = async () => {
+			await closeBrowser();
+			process.exit(0);
+		};
+		process.once("SIGINT", signalHandler);
+		process.once("SIGTERM", signalHandler);
+		process.once("SIGHUP", signalHandler);
+
 		return { browser, context: browser, page, isBrowserRunning: () => !!browser?.connected, closeBrowser, launchError: null };
 	} catch (error) {
 		console.error("Multilogin Launch Error:", error.message);
@@ -685,13 +701,29 @@ async function launchQuickMultiloginProfile({ os_type, proxy, canvas_noise, medi
 		const pages = await browser.pages();
 		const page = pages[0] ?? (await browser.newPage());
 
+		let closing = false;
 		const closeBrowser = 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 { }
 			return await stopMultiloginProfile(profileId);
 		};
 
+		let signalHandler = async () => {
+			await closeBrowser();
+			process.exit(0);
+		};
+		process.once("SIGINT", signalHandler);
+		process.once("SIGTERM", signalHandler);
+		process.once("SIGHUP", signalHandler);
+
 		return { browser, context: browser, page, isBrowserRunning: () => !!browser?.connected, closeBrowser, launchError: null };
 	} catch (error) {
 		console.error("Quick Profile Error:", error);