arn-browser 0.0.8 → 0.0.9

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "arn-browser",
-	"version": "0.0.8",
+	"version": "0.0.9",
 	"description": "A lightweight, browser autmation helper.",
 	"main": "src/index.js",
 	"types": "src/index.d.ts",

package/src/utility/launchBrowser.d.ts

@@ -205,43 +205,53 @@ export interface LaunchOptions {
 }
 
 /**
- * The object returned by launchBrowser.
+ * Successful browser launch result.
+ * When launchError is null, browser/context/page are guaranteed to be valid.
  */
-export interface BrowserController {
-	/**
-	 * The Playwright Browser or BrowserContext instance.
-	 * Note: Multilogin and Persistent profiles return a BrowserContext here.
-	 */
-	browser: Browser | BrowserContext | null;
-
-	/**
-	 * The active BrowserContext.
-	 */
-	context: BrowserContext | null;
-
+export interface BrowserControllerSuccess {
+	/** The Playwright Browser or BrowserContext instance. */
+	browser: Browser | BrowserContext;
+	/** The active BrowserContext. */
+	context: BrowserContext;
 	/**
 	 * The initial Page object.
 	 * When humanize_options is provided, this will be a HumanPage with human-like cursor methods.
 	 * All standard Playwright Page methods are available.
 	 */
-	page: Page | HumanPage | null;
-
-	/**
-	 * Checks if the browser context is currently active.
-	 */
+	page: Page | HumanPage;
+	/** Returns true since the browser is running. */
 	isBrowserRunning: () => boolean;
-
-	/**
-	 * Safely closes the browser and cleans up temporary directories if applicable.
-	 */
+	/** Safely closes the browser and cleans up temporary directories if applicable. */
 	closeBrowser: () => Promise<boolean>;
+	/** No error occurred during launch. */
+	launchError: null;
+}
 
-	/**
-	 * Captures any error that occurred during launch.
-	 */
-	launchError: Error | null;
+/**
+ * Failed browser launch result.
+ * When launchError is set, browser/context/page are null.
+ */
+export interface BrowserControllerError {
+	/** Null on launch failure. */
+	browser: null;
+	/** Null on launch failure. */
+	context: null;
+	/** Null on launch failure. */
+	page: null;
+	/** Returns false since the browser failed to launch. */
+	isBrowserRunning: () => boolean;
+	/** No-op cleanup function. */
+	closeBrowser: () => Promise<boolean>;
+	/** The error that occurred during launch. */
+	launchError: Error;
 }
 
+/**
+ * The object returned by launchBrowser.
+ * Check launchError to discriminate between success and failure states.
+ */
+export type BrowserController = BrowserControllerSuccess | BrowserControllerError;
+
 /**
  * Launches a browser based on the provided options.
  */

package/src/utility/launchBrowser.js

@@ -258,7 +258,7 @@ export async function launchBrowser({
 		return browserInstance;
 	} catch (error) {
 		console.error("❌ [LaunchBrowser] Critical Error:", error.message || error);
-		return { data: null, error: error, closeBrowser: async () => { } };
+		return { browser: null, context: null, page: null, isBrowserRunning: () => false, closeBrowser: async () => false, launchError: error };
 	}
 }
 
@@ -729,7 +729,7 @@ async function launchExistingMultiloginProfile(profileId, humanize_options = nul
 		try {
 			await stopMultiloginProfile(profileId);
 		} catch (e) { }
-		return { data: null, error, closeBrowser: async () => { } };
+		return { browser: null, context: null, page: null, isBrowserRunning: () => false, closeBrowser: async () => false, launchError: error };
 	}
 }
 
@@ -801,7 +801,7 @@ async function launchQuickMultiloginProfile({ os_type, proxy, canvas_noise, medi
 	} catch (error) {
 		console.error("Quick Profile Error:", error);
 		if (profileId) await stopMultiloginProfile(profileId);
-		return { data: null, error, closeBrowser: async () => { } };
+		return { browser: null, context: null, page: null, isBrowserRunning: () => false, closeBrowser: async () => false, launchError: error };
 	}
 }