brave-real-browser 1.5.101 → 1.5.105

package/FEATURES.md

@@ -0,0 +1,265 @@
+# 🎯 Brave-Real-Browser - Complete Features List
+## सभी सुविधाएं (All Features)
+
+---
+
+## ✅ Core Features (मुख्य सुविधाएं)
+
+### 1. 🤖 Anti-Detection Features
+- ✅ Cloudflare bypass support
+- ✅ Bot detection prevention
+- ✅ Puppeteer fingerprint hiding
+- ✅ Rebrowser patches integration
+- ✅ Runtime.enable fix
+- ✅ Mouse movement patching (screenX/screenY fix)
+- ✅ Ghost cursor integration for realistic mouse movements
+- ✅ Real browser behavior simulation
+
+### 2. 🔄 Automatic Dependency Management
+- ✅ **Auto-update on npm install** (NEW! - जोड़ दिया गया)
+- ✅ **Pre-install hook with dependency check**
+- ✅ **Post-install confirmation message**
+- ✅ Weekly Dependabot updates
+- ✅ Weekend Renovate Bot updates
+- ✅ GitHub Actions workflow with auto-updates
+- ✅ Manual update scripts (`update-deps`, `upgrade-all`)
+- ✅ Outdated package checker (`check-updates`)
+- ✅ Environment variable control (SKIP_AUTO_UPDATE)
+- ✅ CI/CD friendly auto-updates
+
+### 3. 🔧 Browser Configuration
+- ✅ Headless mode support (false/true/"new"/"shell")
+- ✅ Custom Chrome/Brave flags support
+- ✅ Custom Chrome path configuration
+- ✅ User data directory (userDataDir) support
+- ✅ Proxy configuration (host, port, username, password)
+- ✅ Viewport customization
+- ✅ Xvfb support for Linux headless environment
+- ✅ Ignore all flags option
+- ✅ Connect options customization
+
+### 4. 🎭 CAPTCHA Handling
+- ✅ Cloudflare Turnstile auto-solve
+- ✅ reCAPTCHA support
+- ✅ hCaptcha support
+- ✅ Automatic CAPTCHA clicking
+
+### 5. 📦 Module System Support
+- ✅ CommonJS (require) support
+- ✅ ES Modules (import) support
+- ✅ TypeScript definitions (typings.d.ts)
+- ✅ Dual package exports
+- ✅ Test files for both module systems
+
+### 6. 🔌 Plugin System
+- ✅ Puppeteer-extra plugin support
+- ✅ Plugin loading during initialization
+- ✅ Custom plugin integration
+- ✅ Plugin compatibility testing
+
+### 7. 🖱️ Mouse & Interaction
+- ✅ Ghost cursor for realistic movements
+- ✅ `page.realClick()` method
+- ✅ `page.realCursor` access
+- ✅ Natural mouse movement simulation
+- ✅ Click and wait for navigation
+
+### 8. 🐳 Docker Support
+- ✅ Dockerfile included
+- ✅ Ubuntu server tested
+- ✅ Xvfb integration in containers
+- ✅ Easy deployment
+
+### 9. 📝 Documentation
+- ✅ Comprehensive README.md
+- ✅ Installation instructions
+- ✅ Usage examples
+- ✅ Configuration guide
+- ✅ FAQ section
+- ✅ Plugin installation guide
+- ✅ Docker guide
+- ✅ **Auto-update documentation** (NEW!)
+- ✅ **Features checklist** (NEW!)
+
+### 10. 🚀 CI/CD Integration
+- ✅ GitHub Actions workflow
+- ✅ Automatic publishing to NPM
+- ✅ Version auto-increment (patch)
+- ✅ Git tagging
+- ✅ GitHub Release creation
+- ✅ Dependency updates in workflow
+- ✅ Skip CI prevention (`[skip ci]`)
+- ✅ Manual workflow dispatch
+- ✅ Duplicate version check
+- ✅ Job status summary
+
+### 11. 🔐 Security Features
+- ✅ Dependabot security alerts
+- ✅ Automated security updates
+- ✅ Vulnerability scanning
+- ✅ Weekly security checks
+
+### 12. 🎨 Developer Experience
+- ✅ ESM test suite
+- ✅ CJS test suite
+- ✅ NPM scripts for common tasks
+- ✅ Helpful console messages
+- ✅ Error handling
+- ✅ Debug mode support
+
+---
+
+## 🆕 Recently Added Features (हाल ही में जोड़ी गई सुविधाएं)
+
+### ✨ Auto-Update System (Latest!)
+- ✅ **Automatic dependency updates on every `npm install`**
+- ✅ **Smart detection of outdated packages**
+- ✅ **Selective update (only core dependencies)**
+- ✅ **Environment variable control**
+- ✅ **Recursion prevention**
+- ✅ **User-friendly console output**
+- ✅ **Error handling with fallback**
+- ✅ **Version display after update**
+- ✅ **Script: `scripts/auto-update.js`**
+
+### 📚 Enhanced Documentation
+- ✅ **Auto-update feature section in README**
+- ✅ **Complete features list (FEATURES.md)**
+- ✅ **Hindi + English documentation**
+- ✅ **Usage examples with environment variables**
+
+---
+
+## 🔄 Dependency Update Mechanisms (सभी तरीके)
+
+### 1. Automatic (स्वचालित)
+1. **npm install** - हर बार auto-update (NEW!)
+2. **GitHub Actions** - हर push पर
+3. **Dependabot** - हर Monday को
+4. **Renovate Bot** - हर weekend को
+
+### 2. Manual (मैनुअल)
+1. **`npm run update-deps`** - सभी dependencies update
+2. **`npm run upgrade-all`** - update + confirmation message
+3. **`npm run check-updates`** - outdated packages देखें
+
+### 3. Control Options (नियंत्रण विकल्प)
+```bash
+# Auto-update disable करें
+SKIP_AUTO_UPDATE=true npm install
+
+# Auto-update enable करें (default)
+npm install
+
+# Check करें बिना update के
+npm run check-updates
+```
+
+---
+
+## 📊 Feature Comparison
+
+| Feature | Status | Auto-Update | Manual Update | CI/CD |
+|---------|--------|-------------|---------------|-------|
+| npm install | ✅ Yes | ✅ Yes (NEW!) | ✅ Yes | ✅ Yes |
+| GitHub Actions | ✅ Yes | ✅ Yes | - | ✅ Yes |
+| Dependabot | ✅ Yes | ✅ Yes | - | ✅ Yes |
+| Renovate Bot | ✅ Yes | ✅ Yes | - | ✅ Yes |
+| Manual Scripts | ✅ Yes | - | ✅ Yes | ✅ Yes |
+
+---
+
+## 🎯 Complete Feature Coverage (सम्पूर्ण सुविधाएं)
+
+### ✅ Installation & Setup
+- [x] NPM package installation
+- [x] Linux xvfb installation guide
+- [x] Windows compatibility
+- [x] MacOS compatibility
+- [x] Docker installation
+- [x] Auto-dependency updates
+
+### ✅ Browser Control
+- [x] Launch Chrome/Brave
+- [x] Connect to existing browser
+- [x] Headless mode
+- [x] Custom flags
+- [x] Proxy support
+- [x] User profiles
+
+### ✅ Anti-Detection
+- [x] Cloudflare bypass
+- [x] Bot detection prevention
+- [x] Fingerprint hiding
+- [x] Natural behavior
+- [x] Mouse movement realism
+
+### ✅ Automation
+- [x] Page navigation
+- [x] Click interactions
+- [x] Form filling
+- [x] Screenshot capture
+- [x] PDF generation
+- [x] Network interception
+
+### ✅ CAPTCHA
+- [x] Turnstile auto-solve
+- [x] reCAPTCHA support
+- [x] hCaptcha support
+- [x] Custom CAPTCHA handlers
+
+### ✅ Development
+- [x] TypeScript support
+- [x] ESM/CJS support
+- [x] Plugin system
+- [x] Test suites
+- [x] Debug mode
+
+### ✅ Maintenance
+- [x] Auto-updates
+- [x] Security patches
+- [x] Version management
+- [x] CI/CD pipeline
+- [x] Release automation
+
+### ✅ Documentation
+- [x] README
+- [x] Examples
+- [x] FAQ
+- [x] API docs
+- [x] Features list
+- [x] Hindi support
+
+---
+
+## 🎉 Summary (सारांश)
+
+**Total Features Implemented: 50+ ✅**
+
+### मुख्य बातें:
+1. ✅ **सभी dependencies अब हर `npm install` पर automatically latest version में update होंगी**
+2. ✅ **GitHub Actions workflow में भी auto-update है**
+3. ✅ **Dependabot और Renovate Bot भी काम कर रहे हैं**
+4. ✅ **Environment variable से control कर सकते हैं**
+5. ✅ **सभी जरूरी features add हो चुके हैं**
+
+### Key Points:
+1. ✅ **All dependencies will automatically update to latest version on every `npm install`**
+2. ✅ **GitHub Actions workflow also has auto-update**
+3. ✅ **Dependabot and Renovate Bot are also working**
+4. ✅ **Can be controlled via environment variable**
+5. ✅ **All essential features have been added**
+
+---
+
+## 📞 Need Help?
+
+- 📖 Read README.md for usage guide
+- 🐛 Report issues on GitHub
+- 💡 Check FAQ section
+- 🔧 Use `npm run check-updates` to verify dependencies
+
+---
+
+**Last Updated:** October 4, 2025  
+**Version:** 1.5.101+

package/README.md

@@ -47,6 +47,38 @@ if you are using linux:
 sudo apt-get install xvfb
 ```
 
+### 🚀 Auto-Update Feature
+
+This package **automatically updates all dependencies to their latest versions** whenever you run `npm install`. This ensures you always have the most recent bug fixes and security patches.
+
+**How it works:**
+- ✅ Automatically checks for outdated dependencies on every `npm install`
+- ✅ Updates only the core dependencies (brave-real-launcher, brave-real-puppeteer-core, etc.)
+- ✅ Works in CI/CD environments (GitHub Actions, etc.)
+- ✅ Can be disabled if needed
+
+**To disable auto-update:**
+```bash
+# Temporarily disable for one install
+SKIP_AUTO_UPDATE=true npm install
+
+# Or set environment variable
+export SKIP_AUTO_UPDATE=true
+npm install
+```
+
+**Manual update commands:**
+```bash
+# Check for outdated dependencies
+npm run check-updates
+
+# Update all dependencies manually
+npm run update-deps
+
+# Or use the convenient command
+npm run upgrade-all
+```
+
 ## Include
 
 ### CommonJS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brave-real-browser",
-  "version": "1.5.101",
+  "version": "1.5.105",
   "description": "This package is designed to bypass puppeteer's bot-detecting captchas such as Cloudflare. It acts like a real browser and can be managed with puppeteer.",
   "main": "lib/cjs/index.js",
   "module": "lib/esm/index.mjs",
@@ -16,8 +16,8 @@
     "esm_test": "node ./test/esm/test.js",
     "cjs_test": "node ./test/cjs/test.js",
     "update-deps": "npm install brave-real-launcher@latest brave-real-puppeteer-core@latest ghost-cursor@latest puppeteer-extra@latest tree-kill@latest xvfb@latest && npm list --depth=0",
-    "preinstall": "echo \"🔍 Checking for dependency updates...\"",
-    "postinstall": "echo \"✅ Installation complete! Run 'npm run update-deps' to update to latest versions\"",
+    "preinstall": "node scripts/auto-update.js",
+    "postinstall": "echo \"✅ Installation complete with latest dependencies!\"",
     "check-updates": "npm outdated || true",
     "upgrade-all": "npm run update-deps && echo \"📦 All dependencies updated to latest versions!\""
   },
@@ -43,8 +43,8 @@
   "author": "zfc-software",
   "license": "ISC",
   "dependencies": {
-    "brave-real-launcher": "^1.2.15",
-    "brave-real-puppeteer-core": "^24.23.0-patch.1",
+    "brave-real-launcher": "^1.2.28",
+    "brave-real-puppeteer-core": "^24.33.0-patch.1",
     "ghost-cursor": "^1.4.1",
     "puppeteer-extra": "^3.3.6",
     "tree-kill": "^1.2.2",

package/scripts/auto-update.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+
+/**
+ * Auto-Update Dependencies Script
+ * 
+ * यह script npm install के दौरान automatically चलता है और
+ * सभी dependencies को latest version में update करता है
+ * 
+ * Environment Variables:
+ * - SKIP_AUTO_UPDATE=true    : Auto-update को disable करने के लिए
+ * - AUTO_UPDATE=false        : Alternative way to disable
+ * - CI=true                  : CI environment में automatically enable
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+// Configuration
+const DEPENDENCIES = [
+  'brave-real-launcher',
+  'brave-real-puppeteer-core',
+  'ghost-cursor',
+  'puppeteer-extra',
+  'tree-kill',
+  'xvfb'
+];
+
+// Check if auto-update should be skipped
+const shouldSkipUpdate = () => {
+  // Skip करें अगर environment variable set है
+  if (process.env.SKIP_AUTO_UPDATE === 'true' || process.env.AUTO_UPDATE === 'false') {
+    console.log('⏭️  Auto-update skipped (SKIP_AUTO_UPDATE=true)');
+    return true;
+  }
+
+  // Skip करें अगर यह khud की installation है (avoid recursion)
+  if (process.env.npm_lifecycle_event === 'preinstall' && process.env.npm_package_name === 'brave-real-browser') {
+    // Check if we're installing from npm registry
+    const isRegistryInstall = process.env.npm_config_argv && 
+                               process.env.npm_config_argv.includes('install') &&
+                               !fs.existsSync(path.join(__dirname, '..', 'package.json'));
+    
+    if (isRegistryInstall) {
+      console.log('📦 Installing from npm registry...');
+      return true;
+    }
+  }
+
+  return false;
+};
+
+// Main update function
+const updateDependencies = () => {
+  try {
+    console.log('\n🔄 Brave-Real-Browser: Checking for dependency updates...\n');
+
+    // Check for outdated packages
+    let outdated = [];
+    try {
+      const result = execSync('npm outdated --json', { 
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'ignore'] // Suppress stderr
+      });
+      outdated = Object.keys(JSON.parse(result || '{}'));
+    } catch (error) {
+      // npm outdated exits with code 1 when there are outdated packages
+      if (error.stdout) {
+        try {
+          outdated = Object.keys(JSON.parse(error.stdout));
+        } catch {}
+      }
+    }
+
+    // Filter केवल हमारी dependencies
+    const outdatedDeps = outdated.filter(dep => DEPENDENCIES.includes(dep));
+
+    if (outdatedDeps.length === 0) {
+      console.log('✅ All dependencies are up to date!\n');
+      return;
+    }
+
+    console.log(`📦 Found ${outdatedDeps.length} outdated dependencies:`);
+    outdatedDeps.forEach(dep => console.log(`   - ${dep}`));
+    console.log('\n🔧 Updating to latest versions...\n');
+
+    // Update सभी outdated dependencies
+    const updateCommand = outdatedDeps.map(dep => `${dep}@latest`).join(' ');
+    execSync(`npm install ${updateCommand}`, {
+      stdio: 'inherit',
+      encoding: 'utf8'
+    });
+
+    console.log('\n✅ Dependencies updated successfully!\n');
+
+    // Show updated versions
+    try {
+      console.log('📋 Current versions:');
+      execSync('npm list --depth=0', { 
+        stdio: 'inherit',
+        encoding: 'utf8' 
+      });
+    } catch (error) {
+      // Ignore errors from npm list
+    }
+
+  } catch (error) {
+    console.error('\n⚠️  Warning: Could not auto-update dependencies');
+    console.error('   You can manually update using: npm run update-deps\n');
+    // Don't fail the installation
+  }
+};
+
+// Main execution
+if (!shouldSkipUpdate()) {
+  updateDependencies();
+} else {
+  console.log('🔍 Checking dependencies...\n');
+}