devtunnel-cli 3.0.10 → 3.0.12

package/README.md

@@ -1,110 +1,126 @@
-# DevTunnel 🚀
-
-**Share your local dev servers worldwide - Zero config tunnel for any framework**
-
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
-[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)](https://github.com/maiz-an/DevTunnel)
-[![npm version](https://img.shields.io/npm/v/devtunnel-cli)](https://www.npmjs.com/package/devtunnel-cli)
-[![GitHub Pages](https://img.shields.io/badge/GitHub-Pages-blue)](https://maiz-an.github.io/DevTunnel/)
-
-🌐 **Website:** [devtunnel.vercel.app](https://devtunnel.vercel.app) | 📦 **npm:** [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli) | 💻 **GitHub Pages:** [maiz-an.github.io/DevTunnel](https://maiz-an.github.io/DevTunnel/)
-
----
-
-## ⚡ Quick Start
-
-### Option 1: Install via npm (Recommended)
-```bash
-npm install -g devtunnel-cli
-devtunnel
-```
-
-### Option 2: Download from GitHub
-
-**Windows:**
-Double-click `START.bat`
-
-**macOS:**
-Double-click `START.command`
-
-**Linux:**
-```bash
-chmod +x START.sh
-./START.sh
-```
-
-**Or use npm:**
-```bash
-npm start
-```
-
----
-
-## ✨ Features
-
-- 🤖 **Fully Automatic** - Cloudflare bundled, no installation needed
-- 🎯 **Zero Config** - No project changes needed
-- 🔗 **Smart Proxy** - Bypasses Vite/React restrictions
-- 🌍 **Cross-Platform** - Windows, macOS, Linux
-- 🚀 **Any Framework** - Works with all
-- 🔄 **Multi-Service** - Cloudflare, Ngrok, LocalTunnel fallback
-- 📹 **Streaming Support** - Handles video/audio files (with limitations for large files)
-
----
-
-## 💡 How to Use
-
-1. Start your dev server: `npm start` or `npm run dev` (whichever your project uses)
-2. Run DevTunnel (see Quick Start above)
-3. Select your project folder
-4. Enter your port (default: 5173 for Vite, 3000 for most others)
-5. Get your public URL and share it! 🌍
-
-**Works with any command:** Vite, Create React App, Next.js, Express, NestJS, etc.
-
----
-
-## 📖 Documentation
-
-Complete docs in `/docs` folder:
-- [Complete Guide](docs/README.md)
-- [Features](docs/FEATURES.md)
-- [Troubleshooting](docs/TROUBLESHOOTING.md)
-- [GitHub Pages Website](docs/DEPLOY-WEBSITE.md)
-
----
-
-## 🛠️ Requirements
-
-- Node.js 16+ (download from [nodejs.org](https://nodejs.org))
-- Internet connection
-- Your dev server running
-
-**No other installations needed!** Cloudflare is automatically bundled on first run.
-
----
-
-## 📄 License
-
-MIT License - see [LICENSE](docs/LICENSE)
-
----
-
-**Version 3.0.6** | Made with ❤️ for developers worldwide
-
----
-
-## 🔍 Search Keywords
-
-**DevTunnel** | **dev tunnel** | **localhost tunnel** | **cloudflare tunnel** | **ngrok alternative** | **port forwarding** | **local development** | **vite tunnel** | **react dev server** | **nextjs tunnel** | **npm devtunnel** | **devtunnel-cli** | **share localhost** | **development tools** | **zero config tunnel**
-
----
-
-## 📦 Installation & Links
-
-- **npm Package**: [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli)
-- **GitHub Repository**: [maiz-an/DevTunnel](https://github.com/maiz-an/DevTunnel)
-- **GitHub Pages**: [maiz-an.github.io/DevTunnel](https://maiz-an.github.io/DevTunnel/)
-- **Official Website**: [devtunnel.vercel.app](https://devtunnel.vercel.app)
-- **Documentation**: [docs/README.md](docs/README.md)
-- **Issues**: [GitHub Issues](https://github.com/maiz-an/DevTunnel/issues)
+# DevTunnel 🚀
+
+**Share your local dev servers worldwide - Zero config tunnel for any framework**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey)](https://github.com/maiz-an/DevTunnel)
+[![npm version](https://img.shields.io/npm/v/devtunnel-cli)](https://www.npmjs.com/package/devtunnel-cli)
+[![GitHub Pages](https://img.shields.io/badge/GitHub-Pages-blue)](https://maiz-an.github.io/DevTunnel/)
+
+🌐 **Website:** [devtunnel.vercel.app](https://devtunnel.vercel.app) | 📦 **npm:** [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli) | 💻 **GitHub Pages:** [maiz-an.github.io/DevTunnel](https://maiz-an.github.io/DevTunnel/)
+
+---
+
+## ⚡ Quick Start
+
+### Step-by-Step Guide
+
+**1. Install DevTunnel (one-time setup):**
+```bash
+npm install -g devtunnel-cli
+```
+
+**2. Navigate to your project directory:**
+```bash
+cd your-project
+```
+
+**3. Start your dev server (in one terminal):**
+```bash
+npm start
+# OR
+npm run dev
+```
+
+**4. Run DevTunnel (in another terminal, same directory):**
+```bash
+cd your-project  # Same directory where you run npm start
+devtunnel        # Auto-detects project and port!
+```
+
+**That's it!** DevTunnel will automatically detect your project and running dev server port.
+
+---
+
+## ✨ Features
+
+- 🤖 **Fully Automatic** - Cloudflare bundled, no installation needed
+- 🎯 **Zero Config** - No project changes needed
+- 🔗 **Smart Proxy** - Bypasses Vite/React restrictions
+- 🌍 **Cross-Platform** - Windows, macOS, Linux
+- 🚀 **Any Framework** - Works with all
+- 🔄 **Multi-Service** - Cloudflare, Ngrok, LocalTunnel fallback
+- 📹 **Streaming Support** - Handles video/audio files (with limitations for large files)
+
+---
+
+## 💡 How to Use
+
+**Important:** Run `devtunnel` from the same directory where you run `npm start` or `npm run dev`!
+
+1. **Install DevTunnel** (one-time): `npm install -g devtunnel-cli`
+2. **Go to your project**: `cd your-project`
+3. **Start your dev server**: `npm start` or `npm run dev` (keep this running)
+4. **Open a new terminal** in the same project directory
+5. **Run DevTunnel**: `devtunnel` (auto-detects everything!)
+6. **Get your public URL** and share it! 🌍
+
+**Example:**
+```bash
+# Terminal 1 - Your dev server
+cd my-react-app
+npm run dev
+
+# Terminal 2 - DevTunnel (same directory!)
+cd my-react-app
+devtunnel
+```
+
+**Works with any framework, API, or backend:** Vite, React, Next.js, Express, NestJS, FastAPI, Flask, Django, Spring Boot, Laravel, and any HTTP/HTTPS server!
+
+---
+
+## 📖 Documentation
+
+Complete docs in `/docs` folder:
+- [Complete Guide](docs/README.md)
+- [Features](docs/FEATURES.md)
+- [Troubleshooting](docs/TROUBLESHOOTING.md)
+- [GitHub Pages Website](docs/DEPLOY-WEBSITE.md)
+
+---
+
+## 🛠️ Requirements
+
+- Node.js 16+ (download from [nodejs.org](https://nodejs.org))
+- Internet connection
+- Your dev server running
+
+**No other installations needed!** Cloudflare is automatically bundled on first run.
+
+---
+
+## 📄 License
+
+MIT License - see [LICENSE](docs/LICENSE)
+
+---
+
+**Version 3.0.11** | Made with ❤️ for developers worldwide
+
+---
+
+## 🔍 Search Keywords
+
+**DevTunnel** | **dev tunnel** | **localhost tunnel** | **cloudflare tunnel** | **ngrok alternative** | **port forwarding** | **local development** | **vite tunnel** | **react dev server** | **nextjs tunnel** | **npm devtunnel** | **devtunnel-cli** | **share localhost** | **development tools** | **zero config tunnel**
+
+---
+
+## 📦 Installation & Links
+
+- **npm Package**: [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli)
+- **GitHub Repository**: [maiz-an/DevTunnel](https://github.com/maiz-an/DevTunnel)
+- **GitHub Pages**: [maiz-an.github.io/DevTunnel](https://maiz-an.github.io/DevTunnel/)
+- **Official Website**: [devtunnel.vercel.app](https://devtunnel.vercel.app)
+- **Documentation**: [docs/README.md](docs/README.md)
+- **Issues**: [GitHub Issues](https://github.com/maiz-an/DevTunnel/issues)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtunnel-cli",
-  "version": "3.0.10",
+  "version": "3.0.12",
   "type": "module",
   "description": "DevTunnel - Share local dev servers worldwide. Zero configuration tunnel for any framework. Install via npm: npm install -g devtunnel-cli. Works with Vite, React, Next.js, Express, NestJS and more.",
   "main": "src/core/start.js",

package/src/core/RUN.js

@@ -9,12 +9,17 @@ import { dirname, join } from "path";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
-// Clear screen before starting
+const originalEmitWarning = process.emitWarning;
+process.emitWarning = function(warning, ...args) {
+  if (typeof warning === 'string' && warning.includes('util._extend')) {
+    return;
+  }
+  return originalEmitWarning.call(this, warning, ...args);
+};
+
 process.stdout.write('\x1B[2J\x1B[0f');
 console.clear();
 
-// Start the main app
-// start.js is in the same directory as RUN.js (src/core/)
 const startPath = join(__dirname, "start.js");
 const child = spawn("node", [startPath], {
   stdio: "inherit",

package/src/core/setup-cloudflared.js

@@ -39,37 +39,59 @@ export function getBinaryPath() {
   return path.join(BIN_DIR, platform, binName);
 }
 
-// Check available disk space (basic check)
 function hasEnoughDiskSpace() {
   try {
     const stats = fs.statfsSync ? fs.statfsSync(BIN_DIR) : null;
     if (stats) {
       const availableSpace = stats.bavail * stats.bsize;
-      const requiredSpace = 50 * 1024 * 1024; // 50MB
+      const requiredSpace = 50 * 1024 * 1024;
       return availableSpace > requiredSpace;
     }
-    return true; // Assume OK if we can't check
+    return true;
   } catch {
-    return true; // Assume OK if check fails
+    return true;
+  }
+}
+
+function safeUnlink(filePath) {
+  try {
+    if (fs.existsSync(filePath)) {
+      fs.unlinkSync(filePath);
+    }
+  } catch (err) {
+    // Ignore permission errors - file might be locked or in use
+    // Will be cleaned up later or on next run
   }
 }
 
 function downloadFile(url, dest, retryCount = 0) {
   return new Promise((resolve, reject) => {
-    // Create directory if needed
     const dir = path.dirname(dest);
     try {
       if (!fs.existsSync(dir)) {
         fs.mkdirSync(dir, { recursive: true });
       }
     } catch (err) {
-      reject(new Error(`Cannot create directory: ${err.message}`));
+      reject(new Error(`Cannot create directory: ${err.message}. Try running as administrator or choose a different location.`));
       return;
     }
 
-    // Create temp file first
     const tempDest = dest + '.download';
-    const file = fs.createWriteStream(tempDest);
+    
+    // Clean up any existing temp file first
+    safeUnlink(tempDest);
+    
+    let file;
+    try {
+      file = fs.createWriteStream(tempDest);
+    } catch (err) {
+      if (err.code === 'EPERM' || err.code === 'EACCES') {
+        reject(new Error(`Permission denied: Cannot write to ${dir}. Try running as administrator or check antivirus settings.`));
+      } else {
+        reject(new Error(`Cannot create download file: ${err.message}`));
+      }
+      return;
+    }
     
     const request = https.get(url, { 
       headers: { 
@@ -78,10 +100,9 @@ function downloadFile(url, dest, retryCount = 0) {
       },
       timeout: 30000 // 30 second timeout
     }, (response) => {
-      // Follow redirects
       if (response.statusCode === 302 || response.statusCode === 301) {
         file.close();
-        fs.unlinkSync(tempDest);
+        safeUnlink(tempDest);
         downloadFile(response.headers.location, dest, retryCount)
           .then(resolve)
           .catch(reject);
@@ -90,7 +111,7 @@ function downloadFile(url, dest, retryCount = 0) {
 
       if (response.statusCode !== 200) {
         file.close();
-        fs.unlinkSync(tempDest);
+        safeUnlink(tempDest);
         reject(new Error(`HTTP ${response.statusCode}: ${response.statusMessage}`));
         return;
       }
@@ -155,20 +176,24 @@ function downloadFile(url, dest, retryCount = 0) {
     request.on('timeout', () => {
       request.destroy();
       file.close();
-      if (fs.existsSync(tempDest)) fs.unlinkSync(tempDest);
+      safeUnlink(tempDest);
       reject(new Error('Download timeout (30 seconds)'));
     });
 
     request.on('error', (err) => {
       file.close();
-      if (fs.existsSync(tempDest)) fs.unlinkSync(tempDest);
+      safeUnlink(tempDest);
       reject(err);
     });
 
     file.on('error', (err) => {
       file.close();
-      if (fs.existsSync(tempDest)) fs.unlinkSync(tempDest);
-      reject(new Error(`File write error: ${err.message}`));
+      safeUnlink(tempDest);
+      if (err.code === 'EPERM' || err.code === 'EACCES') {
+        reject(new Error(`Permission denied: Cannot write to ${tempDest}. Try running as administrator or check antivirus settings.`));
+      } else {
+        reject(new Error(`File write error: ${err.message}`));
+      }
     });
   });
 }
@@ -193,7 +218,15 @@ async function downloadWithRetry(urls, dest, maxRetries = 3) {
         const isLastRetry = retry === maxRetries - 1;
         const isLastUrl = urlIndex === urls.length - 1;
         
-        if (err.message.includes('ENOTFOUND') || err.message.includes('ECONNREFUSED')) {
+        if (err.message.includes('Permission denied') || err.message.includes('EPERM') || err.message.includes('EACCES')) {
+          console.log(`\n❌ Permission Error: ${err.message}`);
+          console.log('\n💡 Solutions:');
+          console.log('   1. Run terminal as Administrator (Right-click → Run as administrator)');
+          console.log('   2. Check if antivirus is blocking file writes');
+          console.log('   3. Check folder permissions for:', path.dirname(dest));
+          console.log('   4. Try installing manually: https://github.com/cloudflare/cloudflared/releases\n');
+          throw err; // Don't retry permission errors
+        } else if (err.message.includes('ENOTFOUND') || err.message.includes('ECONNREFUSED')) {
           console.log(`\n❌ Network error: ${err.message}`);
         } else if (err.message.includes('timeout')) {
           console.log(`\n❌ Download timeout`);
@@ -207,7 +240,7 @@ async function downloadWithRetry(urls, dest, maxRetries = 3) {
         
         if (isLastRetry) {
           console.log('💡 Trying alternative source...\n');
-          break; // Try next URL
+          break;
         }
       }
     }
@@ -240,13 +273,11 @@ export async function setupCloudflared() {
         return binaryPath;
       } else {
         console.log('⚠️  Existing binary not working, re-downloading...\n');
-        fs.unlinkSync(binaryPath);
+        safeUnlink(binaryPath);
       }
     } catch {
       console.log('⚠️  Existing binary corrupted, re-downloading...\n');
-      try {
-        fs.unlinkSync(binaryPath);
-      } catch {}
+      safeUnlink(binaryPath);
     }
   }
 
@@ -303,9 +334,7 @@ export async function setupCloudflared() {
       return binaryPath;
     } else {
       console.error('❌ Downloaded binary not working properly');
-      try {
-        fs.unlinkSync(binaryPath);
-      } catch {}
+      safeUnlink(binaryPath);
       return null;
     }
     
@@ -315,11 +344,20 @@ export async function setupCloudflared() {
     console.error('╚════════════════════════════════════════╝\n');
     console.error(`Reason: ${err.message}\n`);
     
-    console.log('💡 Troubleshooting:');
-    console.log('   1. Check internet connection');
-    console.log('   2. Check firewall/antivirus settings');
-    console.log('   3. Try again later');
-    console.log('   4. Install manually: https://github.com/cloudflare/cloudflared/releases\n');
+    if (err.message.includes('Permission denied') || err.message.includes('EPERM') || err.message.includes('EACCES')) {
+      console.log('💡 Permission Error Solutions:');
+      console.log('   1. Run terminal as Administrator (Right-click → Run as administrator)');
+      console.log('   2. Check antivirus is not blocking file writes');
+      console.log('   3. Check folder permissions for:', path.dirname(binaryPath));
+      console.log('   4. Try installing Cloudflare manually:');
+      console.log('      https://github.com/cloudflare/cloudflared/releases\n');
+    } else {
+      console.log('💡 Troubleshooting:');
+      console.log('   1. Check internet connection');
+      console.log('   2. Check firewall/antivirus settings');
+      console.log('   3. Try running as administrator');
+      console.log('   4. Install manually: https://github.com/cloudflare/cloudflared/releases\n');
+    }
     
     console.log('🔄 DevTunnel will use fallback tunnels (Ngrok/LocalTunnel)\n');
     

package/src/core/start.js

@@ -174,7 +174,6 @@ function showLogo() {
   console.log("");
 }
 
-// Main function
 async function main() {
   // Clear screen - works on Windows, macOS, Linux
   // ANSI escape codes for clear screen + cursor to top
@@ -184,7 +183,7 @@ async function main() {
   // Show ASCII logo
   showLogo();
   
-  console.log("DevTunnel v3.0.10");
+  console.log("DevTunnel v3.0.12");
   console.log("Share your local dev servers worldwide");
   console.log("");
   console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");