brave-real-launcher 1.2.4 → 1.2.8

package/.github/workflows/chrome-launcher-sync.yml

@@ -0,0 +1,354 @@
+name: Chrome Launcher Sync & Publish
+
+on:
+  # Automatic triggers
+  schedule:
+    # Weekly trigger (minimum requirement) - Every Monday at 6 AM UTC
+    - cron: '0 6 * * 1'  # Weekly Monday at 6 AM UTC (11:30 AM IST)
+    # Daily trigger (for frequent updates) - Every day at 6 AM UTC  
+    - cron: '0 6 * * *'  # Daily at 6 AM UTC (11:30 AM IST)
+  
+  # Manual trigger
+  workflow_dispatch:
+    inputs:
+      chrome_launcher_version:
+        description: 'Chrome-launcher version to sync (leave empty for latest)'
+        required: false
+        default: 'latest'
+      force_publish:
+        description: 'Force publish even if no updates'
+        type: boolean
+        default: false
+      skip_tests:
+        description: 'Skip tests (use carefully)'
+        type: boolean
+        default: false
+
+  # Trigger on push to main (for testing)
+  push:
+    branches: [ main, master ]
+    paths:
+      - 'scripts/chrome-launcher-sync.cjs'
+      - '.github/workflows/chrome-launcher-sync.yml'
+
+env:
+  NODE_VERSION: '18'
+  REGISTRY_URL: 'https://registry.npmjs.org'
+
+jobs:
+  check-updates:
+    name: Check for Chrome-launcher Updates
+    runs-on: ubuntu-latest
+    outputs:
+      has_updates: ${{ steps.check.outputs.has_updates }}
+      chrome_version: ${{ steps.check.outputs.chrome_version }}
+      current_version: ${{ steps.check.outputs.current_version }}
+      should_proceed: ${{ steps.check.outputs.should_proceed }}
+    
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Check Chrome-launcher Updates & Version Management
+        id: check
+        run: |
+          echo "🔍 Checking for chrome-launcher updates and version management..."
+          
+          # Get current version from package.json
+          CURRENT_VERSION=$(node -p "require('./package.json').version")
+          echo "current_version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
+          echo "Current brave-real-launcher version: $CURRENT_VERSION"
+          
+          # Get latest chrome-launcher version
+          if [ "${{ github.event.inputs.chrome_launcher_version }}" = "latest" ] || [ -z "${{ github.event.inputs.chrome_launcher_version }}" ]; then
+            # Get latest chrome-launcher version from npm
+            CHROME_VERSION=$(npm view chrome-launcher version)
+            echo "chrome_version=$CHROME_VERSION" >> $GITHUB_OUTPUT
+            echo "Latest chrome-launcher version: $CHROME_VERSION"
+          else
+            CHROME_VERSION="${{ github.event.inputs.chrome_launcher_version }}"
+            echo "chrome_version=$CHROME_VERSION" >> $GITHUB_OUTPUT
+            echo "Target chrome-launcher version: $CHROME_VERSION"
+          fi
+          
+          # Smart version increment logic - ALWAYS proceed for continuous updates
+          FORCE_PUBLISH="${{ github.event.inputs.force_publish }}"
+          
+          # Use version increment utility to determine if we should proceed
+          echo "📦 Running version increment analysis..."
+          node scripts/version-increment.cjs --dry-run --force
+          
+          # We always proceed now for continuous integration
+          echo "has_updates=true" >> $GITHUB_OUTPUT
+          echo "should_proceed=true" >> $GITHUB_OUTPUT
+          
+          if [ "$CURRENT_VERSION" != "$CHROME_VERSION" ]; then
+            echo "✅ Chrome-launcher version sync available: $CURRENT_VERSION → $CHROME_VERSION"
+          else
+            echo "📈 Auto-increment for continuous updates: $CURRENT_VERSION → $CURRENT_VERSION+1"
+          fi
+          
+          echo "🚀 Proceeding with sync and version increment"
+
+  sync-and-build:
+    name: Sync Chrome-launcher & Build
+    runs-on: ubuntu-latest
+    needs: check-updates
+    # Always run for continuous version updates
+    if: always() && needs.check-updates.outputs.should_proceed == 'true'
+    
+    outputs:
+      build_success: ${{ steps.build.outputs.success }}
+      new_version: ${{ steps.sync.outputs.new_version }}
+    
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GH_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+          registry-url: ${{ env.REGISTRY_URL }}
+
+      - name: Configure Git
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Clean up duplicate chrome files
+        run: |
+          echo "🧹 Cleaning up any duplicate chrome files..."
+          node scripts/cleanup-duplicates.cjs
+          echo "✅ Pre-sync cleanup completed"
+
+      - name: Smart Version Increment
+        id: sync
+        run: |
+          echo "📈 Starting smart version increment..."
+          
+          OLD_VERSION="${{ needs.check-updates.outputs.current_version }}"
+          echo "Current version: $OLD_VERSION"
+          
+          # Use version increment utility directly (more reliable)
+          echo "📦 Running version increment..."
+          node scripts/version-increment.cjs --force
+          
+          # Get the new version from package.json (after increment)
+          NEW_VERSION=$(node -p "require('./package.json').version")
+          
+          echo "new_version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          echo "old_version=$OLD_VERSION" >> $GITHUB_OUTPUT
+          
+          echo "✅ Version increment completed: $OLD_VERSION → $NEW_VERSION"
+          
+          # Check if version was incremented
+          if [ "$OLD_VERSION" != "$NEW_VERSION" ]; then
+            echo "📈 Version successfully incremented!"
+            echo "version_incremented=true" >> $GITHUB_OUTPUT
+          else
+            echo "ℹ️ Version remained the same"
+            echo "version_incremented=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Install Updated Dependencies
+        run: |
+          echo "📦 Installing updated dependencies..."
+          npm install
+
+      - name: Build Project
+        id: build
+        run: |
+          echo "🔨 Building project..."
+          npm run build
+          echo "success=true" >> $GITHUB_OUTPUT
+          echo "✅ Build completed successfully"
+
+      - name: Run Tests
+        if: github.event.inputs.skip_tests != 'true'
+        run: |
+          echo "🧪 Running tests..."
+          npm run test:ci
+          echo "✅ All tests passed"
+
+      - name: Verify Build Output
+        run: |
+          echo "🔍 Verifying build outputs..."
+          ls -la dist/
+          node -e "console.log('✅ Build verification:', require('./dist/index.js') ? 'Success' : 'Failed')"
+
+      - name: Commit Changes
+        run: |
+          if git diff --quiet; then
+            echo "No changes to commit"
+          else
+            git add .
+            git commit -m "chore: auto-increment version v${{ steps.sync.outputs.new_version }}
+            
+            - Version increment: ${{ steps.sync.outputs.old_version }} → ${{ steps.sync.outputs.new_version }}
+            - Chrome-launcher reference: v${{ needs.check-updates.outputs.chrome_version }}
+            - Build system: ✅ All tests passing
+            - Dependencies: ✅ Up to date
+            - Features: ✅ All Brave-specific features preserved
+            - Continuous updates: ✅ Smart increment logic
+            
+            Auto-generated by GitHub Actions"
+            
+            git push origin ${{ github.ref_name }}
+            echo "✅ Changes committed and pushed"
+          fi
+
+  publish-npm:
+    name: Publish to NPM
+    runs-on: ubuntu-latest
+    needs: [check-updates, sync-and-build]
+    if: needs.sync-and-build.outputs.build_success == 'true'
+    
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.ref_name }}
+          token: ${{ secrets.GH_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.NODE_VERSION }}
+          cache: 'npm'
+          registry-url: ${{ env.REGISTRY_URL }}
+
+      - name: Install Dependencies
+        run: npm ci
+
+      - name: Build for Publication
+        run: |
+          echo "🔨 Building for publication..."
+          npm run build
+          echo "✅ Build completed"
+
+      - name: Final Tests Before Publish
+        if: github.event.inputs.skip_tests != 'true'
+        run: |
+          echo "🧪 Running final tests..."
+          npm run test:ci
+          echo "✅ All tests passed"
+
+      - name: Check NPM Authentication
+        run: |
+          echo "🔐 Checking NPM authentication..."
+          npm whoami
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Publish to NPM
+        run: |
+          echo "📦 Publishing to NPM..."
+          
+          # Get package info
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          PACKAGE_VERSION=$(node -p "require('./package.json').version")
+          
+          echo "Publishing $PACKAGE_NAME@$PACKAGE_VERSION"
+          
+          # Publish with retry logic
+          npm publish --access public
+          
+          echo "✅ Successfully published $PACKAGE_NAME@$PACKAGE_VERSION"
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub Release
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
+        with:
+          tag_name: v${{ needs.sync-and-build.outputs.new_version }}
+          release_name: Release v${{ needs.sync-and-build.outputs.new_version }}
+          body: |
+            ## 🚀 Chrome-launcher Sync Update
+            
+            This release automatically syncs with **chrome-launcher v${{ needs.check-updates.outputs.chrome_version }}**
+            
+            ### ✨ What's Updated
+            - 🔄 Synced with chrome-launcher v${{ needs.check-updates.outputs.chrome_version }}
+            - 🦁 All Brave-specific features preserved and enhanced
+            - 📦 Dependencies updated to latest versions
+            - 🧪 All tests passing
+            - 🔨 Build system updated
+            
+            ### 📋 Sync Details
+            - **Previous version:** ${{ needs.check-updates.outputs.current_version }}
+            - **New version:** ${{ needs.sync-and-build.outputs.new_version }}
+            - **Chrome-launcher version:** ${{ needs.check-updates.outputs.chrome_version }}
+            - **Auto-published:** ✅ Available on NPM
+            
+            ### 🔗 Links
+            - [NPM Package](https://www.npmjs.com/package/brave-real-launcher)
+            - [Chrome-launcher Repository](https://github.com/GoogleChrome/chrome-launcher)
+            
+            ---
+            *This release was automatically generated by GitHub Actions*
+          draft: false
+          prerelease: false
+
+  notify-completion:
+    name: Notify Completion
+    runs-on: ubuntu-latest
+    needs: [check-updates, sync-and-build, publish-npm]
+    if: always()
+    
+    steps:
+      - name: Workflow Summary
+        run: |
+          echo "## 🎯 Workflow Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          
+          if [ "${{ needs.check-updates.outputs.should_proceed }}" = "true" ]; then
+            echo "### ✅ Updates Processed" >> $GITHUB_STEP_SUMMARY
+            echo "- **Chrome-launcher version:** ${{ needs.check-updates.outputs.chrome_version }}" >> $GITHUB_STEP_SUMMARY
+            echo "- **Previous version:** ${{ needs.check-updates.outputs.current_version }}" >> $GITHUB_STEP_SUMMARY
+            echo "- **New version:** ${{ needs.sync-and-build.outputs.new_version }}" >> $GITHUB_STEP_SUMMARY
+            
+            if [ "${{ needs.sync-and-build.result }}" = "success" ]; then
+              echo "- **Sync & Build:** ✅ Success" >> $GITHUB_STEP_SUMMARY
+            else
+              echo "- **Sync & Build:** ❌ Failed" >> $GITHUB_STEP_SUMMARY
+            fi
+            
+            if [ "${{ needs.publish-npm.result }}" = "success" ]; then
+              echo "- **NPM Publish:** ✅ Success" >> $GITHUB_STEP_SUMMARY
+              echo "- **Package URL:** https://www.npmjs.com/package/brave-real-launcher" >> $GITHUB_STEP_SUMMARY
+            else
+              echo "- **NPM Publish:** ❌ Failed" >> $GITHUB_STEP_SUMMARY
+            fi
+          else
+            echo "### ℹ️ No Updates Required" >> $GITHUB_STEP_SUMMARY
+            echo "- Current version is already up-to-date with chrome-launcher" >> $GITHUB_STEP_SUMMARY
+            echo "- **Current version:** ${{ needs.check-updates.outputs.current_version }}" >> $GITHUB_STEP_SUMMARY
+            echo "- **Chrome-launcher version:** ${{ needs.check-updates.outputs.chrome_version }}" >> $GITHUB_STEP_SUMMARY
+          fi
+          
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### 🔗 Useful Links" >> $GITHUB_STEP_SUMMARY
+          echo "- [Repository](https://github.com/${{ github.repository }})" >> $GITHUB_STEP_SUMMARY
+          echo "- [NPM Package](https://www.npmjs.com/package/brave-real-launcher)" >> $GITHUB_STEP_SUMMARY
+          echo "- [Chrome-launcher](https://github.com/GoogleChrome/chrome-launcher)" >> $GITHUB_STEP_SUMMARY

package/GITHUB_ACTION_SETUP.md

@@ -0,0 +1,221 @@
+# GitHub Action Setup Guide
+
+यह guide आपको brave-real-launcher के लिए GitHub Action workflow setup करने में मदद करेगी।
+
+## 🔑 Required GitHub Secrets
+
+GitHub repository में निम्नलिखित secrets configure करना आवश्यक है:
+
+### 1. GH_TOKEN (GitHub Personal Access Token)
+
+```bash
+# GitHub Personal Access Token with these permissions:
+- repo (Full control of private repositories)
+- workflow (Update GitHub Action workflows)
+- write:packages (Write packages to GitHub Package Registry)
+```
+
+**कैसे बनाएं:**
+1. GitHub.com पर जाएं → Settings → Developer settings → Personal access tokens
+2. "Generate new token (classic)" पर click करें
+3. ऊपर दिए गए permissions select करें
+4. Token generate करें और copy करें
+
+### 2. NPM_TOKEN (NPM Authentication Token)
+
+```bash
+# NPM Token with publish permissions
+- Type: Automation token (recommended)
+- Scope: brave-real-launcher package
+```
+
+**कैसे बनाएं:**
+1. NPM.js पर login करें → Account Settings → Access Tokens
+2. "Generate New Token" → "Automation" select करें
+3. Token generate करें और copy करें
+
+## 📝 Secrets Configuration
+
+GitHub repository में secrets add करें:
+
+```bash
+# Repository में जाएं
+Settings → Secrets and variables → Actions → New repository secret
+
+# Add करें:
+Name: GH_TOKEN
+Value: {{your_github_token}}
+
+Name: NPM_TOKEN  
+Value: {{your_npm_token}}
+```
+
+## 🚀 Workflow Features
+
+### 📈 Auto-increment Version Logic
+- **Smart Versioning**: हमेशा version increment होता है (1.2.0 → 1.2.1 → 1.2.2...)
+- **Chrome-launcher Sync**: Chrome-launcher के version के साथ intelligent sync
+- **Continuous Updates**: जब chrome-launcher version same हो तब भी patch increment
+- **Strategy Support**: Major, Minor, Patch, और Auto increment strategies
+
+### Automatic Triggers
+- **Daily Check**: हर रोज सुबह 6 बजे UTC (11:30 AM IST)
+- **Push Trigger**: scripts या workflow files में changes पर
+- **Always Proceeds**: अब workflow हमेशा run होगी continuous updates के लिए
+
+### Manual Triggers
+```bash
+# GitHub UI से:
+Actions → Chrome Launcher Sync & Publish → Run workflow
+
+# GitHub CLI से:
+gh workflow run chrome-launcher-sync.yml
+
+# Custom parameters के साथ:
+gh workflow run chrome-launcher-sync.yml \
+  -f chrome_launcher_version=1.2.0 \
+  -f force_publish=true \
+  -f skip_tests=false
+```
+
+## 📋 Workflow Jobs
+
+### 1. check-updates
+- chrome-launcher के latest version को check करता है
+- Current version से compare करता है
+- Update available है तो आगे proceed करता है
+
+### 2. sync-and-build
+- Chrome-launcher को sync करता है
+- Brave-specific features preserve करता है
+- Project को build करता है
+- Tests run करता है
+- Changes को commit करता है
+
+### 3. publish-npm
+- NPM पर package publish करता है
+- GitHub release create करता है
+- Version tags add करता है
+
+### 4. notify-completion
+- Workflow summary generate करता है
+- Success/failure status report करता है
+
+## 🔧 Local Testing
+
+Workflow को push करने से पहले local testing कर सकते हैं:
+
+```bash
+# Local validation script run करें
+node test-workflow-local.js
+
+# Version increment test करें
+node scripts/version-increment.cjs --dry-run
+node scripts/version-increment.cjs --dry-run --force
+node scripts/version-increment.cjs --dry-run --strategy=patch
+
+# Actually increment version
+node scripts/version-increment.cjs --force
+
+# Sync script manually test करें
+node scripts/chrome-launcher-sync.cjs latest
+
+# Build process test करें
+npm run build
+npm run test:ci
+```
+
+## 🎯 Manual Workflow Execution
+
+### Basic Run
+```bash
+# Default settings के साथ
+gh workflow run chrome-launcher-sync.yml
+```
+
+### Advanced Run
+```bash
+# Specific version target करें
+gh workflow run chrome-launcher-sync.yml \
+  -f chrome_launcher_version=1.1.0
+
+# Force publish करें
+gh workflow run chrome-launcher-sync.yml \
+  -f force_publish=true
+
+# Tests skip करें (careful!)
+gh workflow run chrome-launcher-sync.yml \
+  -f skip_tests=true
+```
+
+## 📊 Monitoring
+
+### Workflow Status Check
+```bash
+# Recent workflow runs देखें
+gh run list
+
+# Specific run details
+gh run view <run-id>
+
+# Logs देखें
+gh run view <run-id> --log
+```
+
+### NPM Package Verification
+```bash
+# Published version check करें
+npm view brave-real-launcher version
+
+# Package info देखें
+npm info brave-real-launcher
+```
+
+## 🚨 Troubleshooting
+
+### Common Issues
+
+#### 1. GH_TOKEN Permission Error
+```
+Error: Resource not accessible by integration
+```
+**Solution:** GH_TOKEN में `repo` और `workflow` permissions check करें
+
+#### 2. NPM_TOKEN Authentication Error
+```
+Error: Unable to authenticate with npm
+```
+**Solution:** NPM_TOKEN valid है और `automation` type का है verify करें
+
+#### 3. Build Failures
+```
+Error: TypeScript compilation failed
+```
+**Solution:** Local build test करें और dependencies update करें
+
+#### 4. Sync Script Failures
+```
+Error: Chrome-launcher sync failed
+```
+**Solution:** Internet connection check करें और git access verify करें
+
+## 📈 Success Metrics
+
+Workflow successfully run होने पर:
+- ✅ brave-real-launcher npm पर published
+- ✅ GitHub release created
+- ✅ Version tags updated
+- ✅ All Brave features preserved
+- ✅ Tests passing
+- ✅ Documentation updated
+
+## 🔗 Useful Links
+
+- [GitHub Actions Documentation](https://docs.github.com/en/actions)
+- [NPM Publishing Guide](https://docs.npmjs.com/packages-and-modules/contributing-packages-to-the-registry)
+- [Chrome-launcher Repository](https://github.com/GoogleChrome/chrome-launcher)
+- [Brave-real-launcher NPM](https://www.npmjs.com/package/brave-real-launcher)
+
+---
+
+**Next Step:** Push करने से पहले सुनिश्चित करें कि GitHub secrets properly configured हैं।

package/GITHUB_SETUP.md

@@ -43,7 +43,7 @@ Repository में changes commit करने के लिए:
 - Name: `GH_TOKEN`
 - Value: आपका personal access token
 
-## 🚀 Workflow Triggers
+## 🚀 Simple Workflow Triggers
 
 ### 1. ऑटोमेटिक Triggers
 ```yaml
@@ -56,9 +56,9 @@ schedule:
 Repository पर जाकर:
 1. Actions tab → "Brave Real Launcher - Auto Sync & Publish"
 2. "Run workflow" button click करें
-3. Options select करें:
-   - **Sync Mode**: auto, force, check
-   - **Publish Mode**: auto, force, skip
+3. Simple Options:
+   - **Force Sync**: जबरदस्ती chrome-launcher sync करें
+   - **Skip Tests**: तेजी execution के लिए tests skip करें
 
 ### 3. Push/PR Triggers
 ```yaml
@@ -108,14 +108,15 @@ Workflow की status check करने के लिए:
 - Network connectivity check करें
 - GitHub API rate limits check करें
 
-## 📊 Workflow Features
+## 📊 Simple Workflow Features
 
-✅ **Auto Sync**: Chrome-launcher के साथ automatic sync  
-✅ **Smart Publishing**: Version changes पर automatic publish  
-✅ **Comprehensive Testing**: Full test suite including browser launch  
-✅ **Security Audit**: NPM security vulnerability check  
-✅ **Multi-mode Support**: Manual और automatic triggers  
-✅ **Secure Token Usage**: Safe handling of GH_TOKEN और NPM_TOKEN  
+✅ **Auto Chrome-launcher Sync**: ऑटोमेटिक chrome-launcher integration with all features  
+✅ **Smart Version Management**: Intelligent version increment and NPM publish  
+✅ **Dual Module Support**: CommonJS + ES Module builds maintained  
+✅ **Comprehensive Testing**: Full test suite with browser environment  
+✅ **Security First**: Secure token handling + NPM security audit  
+✅ **Simple Controls**: Just 2 options - Force Sync + Skip Tests  
+✅ **Complete Automation**: One workflow does everything automatically
 
 ---