devtunnel-cli 3.0.39 → 3.0.41

package/README.md

@@ -14,10 +14,7 @@
 
 DevTunnel-CLI is designed for **DEVELOPMENT**, **TESTING**, **DEMOS**, and **WEBHOOK DEBUGGING**. It provides fast, frictionless access to your local dev servers from anywhere.
 
-**This tool is NOT intended for:**
-- Production environments
-- Long-lived public services
-- Hosting production traffic
+DevTunnel-CLI is optimized for development workflows — rapid sharing, demos, and debugging. For production-facing use, consider managed or enterprise tunnel solutions that provide governance, identity, and long-lived endpoints.
 
 DevTunnel-CLI is built for developers who need instant, temporary public URLs to share work-in-progress, test on mobile devices, demo features to clients, or debug webhooks from third-party services.
 
@@ -28,16 +25,19 @@ DevTunnel-CLI is built for developers who need instant, temporary public URLs to
 ### Step-by-Step Guide
 
 **1. Install DevTunnel (one-time setup):**
+
 ```bash
-npm install -g devtunnel-cli
+npm i -g devtunnel-cli
 ```
 
 **2. Navigate to your project directory:**
+
 ```bash
 cd your-project
 ```
 
 **3. Have your app running (in one terminal):**
+
 ```bash
 npm run dev
 # OR  php artisan serve   (Laravel)
@@ -46,6 +46,7 @@ npm run dev
 ```
 
 **4. Run DevTunnel (in another terminal, same directory):**
+
 ```bash
 cd your-project  # Same directory as your project
 devtunnel-cli    # Auto-detects project type and port!
@@ -63,7 +64,7 @@ devtunnel-cli    # Auto-detects project type and port!
 - 🌍 **Cross-Platform** - Windows, macOS, Linux
 - 🚀 **Any Framework** - Node, React, Laravel, plain HTML, PHP/XAMPP
 - 📄 **HTML** - Default port 5500; built-in static server if none running
-- 🐘 **PHP/XAMPP** - Port 80; supports htdocs subfolders (e.g. http://localhost/YourProject/)
+- 🐘 **PHP/XAMPP** - Port 80; supports htdocs subfolders (e.g. <http://localhost/YourProject/>)
 - 🔄 **Multi-Service** - Cloudflare, Ngrok, LocalTunnel fallback
 - 🔌 **Multiple Ports** - DevTunnel-CLI supports multiple ports; auto-detects or lets you choose
 - 📹 **Streaming Support** - Handles video/audio files (with limitations for large files)
@@ -74,7 +75,7 @@ devtunnel-cli    # Auto-detects project type and port!
 
 **Important:** Run `devtunnel-cli` from the same directory as your project!
 
-1. **Install DevTunnel** (one-time): `npm install -g devtunnel-cli`
+1. **Install DevTunnel** (one-time): `npm i -g devtunnel-cli`
 2. **Go to your project**: `cd your-project` (Node, Laravel, HTML, or XAMPP folder)
 3. **Have your app running**: `npm run dev`, `php artisan serve`, or XAMPP. For HTML, optional — DevTunnel can serve it.
 4. **Open a new terminal** in the same project directory
@@ -82,6 +83,7 @@ devtunnel-cli    # Auto-detects project type and port!
 6. **Get your public URL** and share it! 🌍
 
 **Example (Node):**
+
 ```bash
 # Terminal 1
 cd my-react-app

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "devtunnel-cli",
-  "version": "3.0.39",
+  "version": "3.0.41",
   "type": "module",
-  "description": "DevTunnel-CLI — fast, zero-config tool to share local servers for development, testing, demos, and webhook debugging. npm install -g devtunnel-cli.",
+  "description": "DevTunnel-CLI — fast, zero-config tool to share local servers for development, testing, demos, and webhook debugging. npm i -g devtunnel-cli.",
   "main": "src/core/start.js",
   "files": [
     "README.md",
@@ -16,7 +16,9 @@
     "dev": "node src/core/RUN.js",
     "run": "node src/core/RUN.js",
     "tunnel": "node src/core/index.js",
-    "sync-version": "node sync-version.js"
+    "sync-version": "node sync-version.js",
+    "test": "node -e \"console.log('ok')\"",
+    "prepublishOnly": "npm test"
   },
   "keywords": [
     "DevTunnel-CLI",

package/src/core/setup-cloudflared.js

@@ -69,7 +69,7 @@ async function isAdmin() {
   if (process.platform !== 'win32') {
     return process.getuid && process.getuid() === 0;
   }
-  
+
   try {
     const { stdout } = await execAsync('net session');
     return stdout.length > 0;
@@ -84,7 +84,7 @@ function showPermissionSolutions(dirPath) {
     console.log('   1. Run terminal as Administrator (Right-click → Run as administrator)');
     console.log('   2. DevTunnel will automatically request admin privileges if needed');
   } else {
-        console.log('   1. Run with sudo: sudo npm install -g devtunnel-cli');
+    console.log('   1. Run with sudo: sudo npm i -g devtunnel-cli');
   }
   console.log('   2. Check if antivirus is blocking file writes');
   console.log('   3. Check folder permissions for:', dirPath);
@@ -104,10 +104,10 @@ function downloadFile(url, dest, retryCount = 0) {
     }
 
     const tempDest = dest + '.download';
-    
+
     // Clean up any existing temp file first
     safeUnlink(tempDest);
-    
+
     let file;
     try {
       file = fs.createWriteStream(tempDest);
@@ -119,9 +119,9 @@ function downloadFile(url, dest, retryCount = 0) {
       }
       return;
     }
-    
-    const request = https.get(url, { 
-      headers: { 
+
+    const request = https.get(url, {
+      headers: {
         'User-Agent': 'DevTunnel/3.0',
         'Accept': '*/*'
       },
@@ -170,9 +170,9 @@ function downloadFile(url, dest, retryCount = 0) {
               fs.unlinkSync(dest);
             }
             fs.renameSync(tempDest, dest);
-            
+
             console.log('\n✅ Download complete');
-            
+
             // Make executable on Unix-like systems
             if (process.platform !== 'win32') {
               try {
@@ -183,7 +183,7 @@ function downloadFile(url, dest, retryCount = 0) {
                 console.log('   Run: chmod +x ' + dest);
               }
             }
-            
+
             // Verify file size
             const stats = fs.statSync(dest);
             if (stats.size < 1000000) { // Less than 1MB is suspicious
@@ -191,7 +191,7 @@ function downloadFile(url, dest, retryCount = 0) {
               reject(new Error('Downloaded file is too small (corrupted)'));
               return;
             }
-            
+
             resolve();
           } catch (err) {
             reject(new Error(`Cannot finalize download: ${err.message}`));
@@ -230,30 +230,30 @@ async function downloadWithRetry(urls, dest, maxRetries = 3) {
   for (let urlIndex = 0; urlIndex < urls.length; urlIndex++) {
     const url = urls[urlIndex];
     console.log(`📥 Source: ${urlIndex === 0 ? 'GitHub' : 'Mirror'} (${urlIndex + 1}/${urls.length})`);
-    
+
     for (let retry = 0; retry < maxRetries; retry++) {
       try {
         if (retry > 0) {
           console.log(`🔄 Retry ${retry}/${maxRetries - 1}...`);
           await new Promise(resolve => setTimeout(resolve, 2000)); // Wait 2s before retry
         }
-        
+
         await downloadFile(url, dest, retry);
         return true; // Success!
-        
+
       } catch (err) {
         const isLastRetry = retry === maxRetries - 1;
         const isLastUrl = urlIndex === urls.length - 1;
-        
+
         if (err.message.includes('Permission denied') || err.message.includes('EPERM') || err.message.includes('EACCES')) {
           console.log(`\n❌ Permission Error: ${err.message}`);
-          
+
           if (process.platform === 'win32' && retry === 0) {
             const admin = await isAdmin();
             if (!admin) {
               console.log('\n🔐 Attempting to request administrator privileges...');
               console.log('   Please click "Yes" on the UAC prompt\n');
-              
+
               try {
                 const nodePath = process.execPath;
                 const scriptPath = process.argv[1];
@@ -266,16 +266,16 @@ async function downloadWithRetry(urls, dest, maxRetries = 3) {
                   stdio: 'inherit',
                   shell: false
                 });
-                
+
                 proc.on('close', () => {
                   process.exit(0);
                 });
-                
+
                 proc.on('error', () => {
                   console.log('\n⚠️  Could not elevate privileges automatically');
                   showPermissionSolutions(path.dirname(dest));
                 });
-                
+
                 return false;
               } catch {
                 showPermissionSolutions(path.dirname(dest));
@@ -283,7 +283,7 @@ async function downloadWithRetry(urls, dest, maxRetries = 3) {
               }
             }
           }
-          
+
           showPermissionSolutions(path.dirname(dest));
           throw err;
         } else if (err.message.includes('ENOTFOUND') || err.message.includes('ECONNREFUSED')) {
@@ -293,11 +293,11 @@ async function downloadWithRetry(urls, dest, maxRetries = 3) {
         } else {
           console.log(`\n❌ Error: ${err.message}`);
         }
-        
+
         if (isLastRetry && isLastUrl) {
           throw new Error(`All download attempts failed: ${err.message}`);
         }
-        
+
         if (isLastRetry) {
           console.log('💡 Trying alternative source...\n');
           break;
@@ -305,18 +305,18 @@ async function downloadWithRetry(urls, dest, maxRetries = 3) {
       }
     }
   }
-  
+
   throw new Error('All download sources failed');
 }
 
 export async function setupCloudflared() {
   const platform = process.platform;
   const binaryPath = getBinaryPath();
-  
+
   console.log('\n╔════════════════════════════════════════╗');
   console.log('║   📦 Cloudflare Setup (First Run)    ║');
   console.log('╚════════════════════════════════════════╝\n');
-  
+
   // Check if binary already exists
   if (fs.existsSync(binaryPath)) {
     try {
@@ -327,7 +327,7 @@ export async function setupCloudflared() {
         testProc.on('error', () => resolve(false));
         setTimeout(() => resolve(false), 5000);
       });
-      
+
       if (works) {
         console.log('✅ Cloudflare already installed and working\n');
         return binaryPath;
@@ -351,13 +351,13 @@ export async function setupCloudflared() {
   console.log(`🖥️  Platform: ${getPlatformName()}`);
   console.log(`📍 Install to: ${binaryPath}`);
   console.log(`📊 Size: ~40 MB\n`);
-  
+
   // Check disk space
   if (!hasEnoughDiskSpace()) {
     console.error('❌ ERROR: Not enough disk space (need 50+ MB)\n');
     return null;
   }
-  
+
   // Check write permissions
   try {
     const dir = path.dirname(binaryPath);
@@ -373,12 +373,12 @@ export async function setupCloudflared() {
     console.error(`   Reason: ${err.message}\n`);
     return null;
   }
-  
+
   console.log('📥 Starting download...\n');
-  
+
   try {
     await downloadWithRetry(urls, binaryPath);
-    
+
     // Final verification
     console.log('\n🔍 Verifying installation...');
     const testProc = spawn(binaryPath, ['--version'], { shell: true, stdio: 'pipe' });
@@ -387,7 +387,7 @@ export async function setupCloudflared() {
       testProc.on('error', () => resolve(false));
       setTimeout(() => resolve(false), 5000);
     });
-    
+
     if (works) {
       console.log('✅ Verification successful!');
       console.log('✅ Cloudflare ready to use\n');
@@ -397,13 +397,13 @@ export async function setupCloudflared() {
       safeUnlink(binaryPath);
       return null;
     }
-    
+
   } catch (err) {
     console.error('\n╔════════════════════════════════════════╗');
     console.error('║   ❌ Installation Failed              ║');
     console.error('╚════════════════════════════════════════╝\n');
     console.error(`Reason: ${err.message}\n`);
-    
+
     if (err.message.includes('Permission denied') || err.message.includes('EPERM') || err.message.includes('EACCES')) {
       showPermissionSolutions(path.dirname(binaryPath));
     } else {
@@ -413,9 +413,9 @@ export async function setupCloudflared() {
       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');
-    
+
     return null;
   }
 }

package/src/core/start.js

@@ -17,10 +17,10 @@ function getPackageVersion() {
     const pkgPath = join(PROJECT_ROOT, "package.json");
     if (existsSync(pkgPath)) {
       const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-      return pkg.version || "3.0.38";
+      return pkg.version || "3.0.41";
     }
   } catch (err) { }
-  return "3.0.38";
+  return "3.0.41";
 }
 
 // Helper to run command

package/src/utils/pages/index.html

@@ -5,7 +5,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <meta name="description"
-    content="DevTunnel - Share local dev servers worldwide. Zero configuration tunnel for any framework. Install via npm: npm install -g devtunnel-cli">
+    content="DevTunnel - Share local dev servers worldwide. Zero configuration tunnel for any framework. Install via npm: npm i -g devtunnel-cli">
   <meta name="keywords"
     content="dev tunnel, localhost tunnel, cloudflare, ngrok, port forwarding, local development, vite, react, nextjs, laravel, php, html, npm install, devtunnel">
   <meta name="author" content="maiz">
@@ -13,7 +13,7 @@
   <link rel="canonical" href="https://devtunnel-cli.vercel.app/">
   <meta property="og:title" content="DevTunnel - Share Local Servers Worldwide">
   <meta property="og:description"
-    content="Zero configuration tunnel for any framework. Install via npm: npm install -g devtunnel-cli">
+    content="Zero configuration tunnel for any framework. Install via npm: npm i -g devtunnel-cli">
   <meta property="og:url" content="https://devtunnel-cli.vercel.app/">
   <meta property="og:type" content="website">
   <meta property="og:image" content="https://devtunnel-cli.vercel.app/og-image.png">
@@ -83,7 +83,7 @@
 
   <h2>⚡ Quick Start</h2>
   <h3>Install via npm (Recommended)</h3>
-  <pre><code>npm install -g devtunnel-cli
+  <pre><code>npm i -g devtunnel-cli
 devtunnel-cli</code></pre>
 
   <h2>✨ Features</h2>
@@ -112,7 +112,21 @@ devtunnel-cli</code></pre>
   </ul>
 
   <hr>
-  <p><small>Version 3.0.38 | Made with ❤︎ for developers worldwide</small></p>
+  <p><small>Version <span id="pkg-version">3.0.41</span> | Made with ❤︎ for developers worldwide</small></p>
+
+  <script>
+    (async function () {
+      try {
+        const res = await fetch('https://registry.npmjs.org/devtunnel-cli');
+        if (!res.ok) return;
+        const data = await res.json();
+        const latest = data && data['dist-tags'] && data['dist-tags'].latest;
+        if (latest) document.getElementById('pkg-version').textContent = latest;
+      } catch (e) {
+        // keep static version if fetch fails
+      }
+    })();
+  </script>
 </body>
 
 </html>