human-browser 3.5.0 → 3.6.0

package/README.md

@@ -26,11 +26,14 @@ Human Browser solves this by combining:
 
 ## Quick Start
 
+**No setup required** — just call `launchHuman()` and it automatically activates a free trial:
+
 ```js
 const { launchHuman } = require('./scripts/browser-human');
 
-// Default: iPhone 15 Pro + Romania residential IP
+// 🚀 Zero config — auto-fetches trial credentials from humanbrowser.dev
 const { browser, page, humanType, humanClick, humanScroll, sleep } = await launchHuman();
+// Output: 🎉 Human Browser trial activated! (~100MB Romania residential IP)
 
 // Specific country
 const { page } = await launchHuman({ country: 'us' }); // US residential IP
@@ -46,6 +49,8 @@ await humanClick(page, 760, 400);
 await browser.close();
 ```
 
+> **Trial exhausted?** Get a paid plan at https://humanbrowser.dev, then set `PROXY_USER` / `PROXY_PASS` in your `.env`.
+
 ---
 
 ## Setup

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "human-browser",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "Stealth browser for AI agents. Bypasses Cloudflare, DataDome, PerimeterX. Residential IPs from 10+ countries. iPhone 15 Pro fingerprint. Drop-in Playwright replacement — launchHuman() just works.",
   "keywords": [
     "browser-automation",

package/scripts/browser-human.js

@@ -37,20 +37,18 @@ const COUNTRY_META = {
 function buildProxy(country = 'ro') {
   const c = country.toLowerCase();
 
-  // Proxy config — use env vars or defaults (Decodo Romania, no KYC)
-  const PROXY_HOST = process.env.PROXY_HOST || 'ro.decodo.com';
+  // Proxy config — use env vars (set manually or auto-fetched via getTrial())
+  const PROXY_HOST = process.env.PROXY_HOST || '';
   const PROXY_PORT = process.env.PROXY_PORT || '13001';
-  const PROXY_USER = process.env.PROXY_USER || 'spikfblbkh';
-  const PROXY_PASS = process.env.PROXY_PASS || 'pe4tpmWY=7bb89YdWd';
+  const PROXY_USER = process.env.PROXY_USER || '';
+  const PROXY_PASS = process.env.PROXY_PASS || '';
 
   // Also support legacy env var names for backward compatibility
-  const server   = process.env.PROXY_SERVER   || `http://${PROXY_HOST}:${PROXY_PORT}`;
+  const server   = process.env.PROXY_SERVER   || (PROXY_HOST ? `http://${PROXY_HOST}:${PROXY_PORT}` : '');
   const username = process.env.PROXY_USERNAME || PROXY_USER;
   const password = process.env.PROXY_PASSWORD || PROXY_PASS;
 
   if (!username || !password) {
-    console.warn('⚠️  No proxy credentials set. Get them at: https://humanbrowser.dev');
-    console.warn('    Set PROXY_USER and PROXY_PASS in your .env file.');
     return null;
   }
 
@@ -188,6 +186,16 @@ async function launchHuman(opts = {}) {
     headless = true,
   } = opts;
 
+  // Auto-fetch trial credentials if no proxy is configured
+  if (useProxy && !process.env.PROXY_USER && !process.env.PROXY_SERVER && !process.env.PROXY_USERNAME) {
+    try {
+      await getTrial();
+    } catch (e) {
+      console.warn('⚠️  Could not fetch trial credentials:', e.message);
+      console.warn('   Get credentials at: https://humanbrowser.dev');
+    }
+  }
+
   const meta   = COUNTRY_META[country.toLowerCase()] || COUNTRY_META.ro;
   const device = buildDevice(mobile, country);
   const proxy  = useProxy ? buildProxy(country) : null;