devtunnel-cli 3.0.37 → 3.0.39

package/README.md

@@ -96,92 +96,6 @@ devtunnel-cli
 
 ---
 
-## 🔒 Security & Access Model
-
-DevTunnel-CLI intentionally **does NOT use authentication or access control**. This is a deliberate design choice to ensure fast, frictionless development workflows.
-
-**How Access Works:**
-- Anyone with the generated temporary URL can access the tunnel until it is stopped
-- No login, password, or identity verification required
-- Access is limited by **possession of the URL only**
-
-**Why This Design?**
-- **Speed**: Get public URLs instantly without authentication setup
-- **Simplicity**: Zero configuration — just run and share
-- **Friction-free collaboration**: Share with teammates without managing accounts or permissions
-
-**Temporary URL Behavior:**
-- URLs are **short-lived** and **unlisted**
-- URLs are **destroyed** when the tunnel stops
-- New random URLs are generated each time you run DevTunnel-CLI
-- URLs are not indexed by search engines
-
-**Best Practices:**
-- Only share URLs with trusted collaborators
-- Stop the tunnel when not in use
-- Never expose sensitive data or production databases through DevTunnel-CLI
-- Use for development and testing only
-
----
-
-## ⚠️ Limitations
-
-DevTunnel-CLI has intentional limitations that make it ideal for development but unsuitable for other use cases:
-
-### No Authentication or Access Control
-- **By design**: No identity-based access control
-- **By design**: No user-level permission management
-- **By design**: No password protection or login system
-- Anyone with the URL can access your tunnel
-
-### Not Suitable For
-- ❌ Production environments
-- ❌ Long-lived public services
-- ❌ Hosting production traffic
-- ❌ Sensitive data exposure
-- ❌ Public-facing applications
-
-### Perfect For
-- ✅ Development and testing
-- ✅ Team collaboration and code reviews
-- ✅ Mobile device testing
-- ✅ Client demos and work-in-progress sharing
-- ✅ Webhook debugging with third-party services
-- ✅ Temporary public access to localhost
-
-### File Size & Streaming Limits
-- ✅ Small files (<10MB): Works perfectly
-- ✅ Medium files (10-50MB): Works well, may have slight delays
-- ⚠️ Large files (>50MB): May timeout depending on connection speed
-- ⚠️ Very large files (>100MB): Not recommended for Cloudflare free tier
-
----
-
-## 🆚 Comparison: DevTunnel-CLI vs. Enterprise Tunnels
-
-DevTunnel-CLI is optimized for **speed and simplicity** rather than governance and authentication.
-
-| Feature | DevTunnel-CLI | Enterprise Tunnels (e.g., Microsoft Dev Tunnels) |
-|---------|---------------|--------------------------------------------------|
-| **Setup Time** | Instant (0 config) | Requires account, authentication setup |
-| **Authentication** | None (by design) | User-based auth, SSO, identity management |
-| **Access Control** | URL possession only | Fine-grained permissions, user/group policies |
-| **Use Case** | Development, testing, demos | Enterprise dev, governed access, compliance |
-| **Speed** | Instant sharing | May require approval workflows |
-| **Ideal For** | Solo devs, small teams, fast iteration | Large orgs, regulated industries, prod-like envs |
-
-**Choose DevTunnel-CLI when:**
-- You need instant, frictionless sharing
-- You're working on non-sensitive development projects
-- Speed and simplicity are priorities
-
-**Choose enterprise tunnels when:**
-- You need identity-based access control
-- You're in a regulated or compliance-heavy environment
-- You need audit logs and governance
-
----
-
 ## 📖 Documentation
 
 - [Features](docs/FEATURES.md)

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "devtunnel-cli",
-  "version": "3.0.37",
+  "version": "3.0.39",
   "type": "module",
-  "description": "DevTunnel-CLI (DevTunnel, devtunnel, dev-tunnel) - Development tool for sharing local servers worldwide. Zero config, supports multiple ports. For dev, testing, demos, webhook debugging. Not for production. npm install -g devtunnel-cli. Works with Vite, React, Laravel, HTML, PHP/XAMPP.",
+  "description": "DevTunnel-CLI — fast, zero-config tool to share local servers for development, testing, demos, and webhook debugging. npm install -g devtunnel-cli.",
   "main": "src/core/start.js",
   "files": [
     "README.md",
@@ -15,7 +15,8 @@
     "start": "node src/core/RUN.js",
     "dev": "node src/core/RUN.js",
     "run": "node src/core/RUN.js",
-    "tunnel": "node src/core/index.js"
+    "tunnel": "node src/core/index.js",
+    "sync-version": "node sync-version.js"
   },
   "keywords": [
     "DevTunnel-CLI",
@@ -62,6 +63,7 @@
   ],
   "author": "maiz",
   "license": "MIT",
+  "preferGlobal": true,
   "repository": {
     "type": "git",
     "url": "git+https://github.com/maiz-an/DevTunnel-CLI.git"
@@ -79,4 +81,4 @@
     "prompts": "^2.4.2"
   },
   "devDependencies": {}
-}
+}

package/src/core/start.js

@@ -17,25 +17,25 @@ function getPackageVersion() {
     const pkgPath = join(PROJECT_ROOT, "package.json");
     if (existsSync(pkgPath)) {
       const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
-      return pkg.version || "3.0.35";
+      return pkg.version || "3.0.38";
     }
-  } catch (err) {}
-  return "3.0.35";
+  } catch (err) { }
+  return "3.0.38";
 }
 
 // Helper to run command
 function runCommand(command, args = [], cwd = process.cwd()) {
   return new Promise((resolve) => {
-    const proc = spawn(command, args, { 
-      shell: true, 
+    const proc = spawn(command, args, {
+      shell: true,
       stdio: "pipe",
       cwd: cwd
     });
     let output = "";
-    
+
     proc.stdout?.on("data", (data) => output += data.toString());
     proc.stderr?.on("data", (data) => output += data.toString());
-    
+
     proc.on("close", (code) => resolve({ code, output }));
     proc.on("error", () => resolve({ code: 1, output: "" }));
   });
@@ -51,7 +51,7 @@ async function commandExists(command) {
 function checkPortInUse(port) {
   return new Promise((resolve) => {
     const server = http.createServer();
-    
+
     server.once('error', (err) => {
       // Port is in use
       if (err.code === 'EADDRINUSE') {
@@ -60,7 +60,7 @@ function checkPortInUse(port) {
         resolve(false);
       }
     });
-    
+
     server.listen(port, () => {
       // Port is available (not in use)
       server.once('close', () => resolve(false));
@@ -79,7 +79,7 @@ async function waitForServerReady(port, timeoutMs = 10000) {
         req.on("error", () => resolve(null));
       });
       if (code !== null && code >= 200 && code < 500) return true;
-    } catch (err) {}
+    } catch (err) { }
     await new Promise((r) => setTimeout(r, 300));
   }
   return false;
@@ -91,24 +91,24 @@ function detectPortFromPackage(packagePath) {
     if (!existsSync(packagePath)) return null;
     const packageJson = JSON.parse(readFileSync(packagePath, 'utf8'));
     const scripts = packageJson.scripts || {};
-    
+
     // Check for common dev commands
     const devScript = scripts.dev || scripts.start || scripts.serve;
     if (!devScript) return null;
-    
+
     // Try to extract port from script
     const portMatch = devScript.match(/--port\s+(\d+)|:(\d+)|port[=:](\d+)/i);
     if (portMatch) {
       return parseInt(portMatch[1] || portMatch[2] || portMatch[3]);
     }
-    
+
     // Default ports based on framework
     if (devScript.includes('vite')) return 5173;
     if (devScript.includes('next')) return 3000;
     if (devScript.includes('react-scripts')) return 3000;
     if (devScript.includes('webpack')) return 8080;
     if (devScript.includes('express')) return 3000;
-    
+
     return null;
   } catch (err) {
     return null;
@@ -148,7 +148,7 @@ function detectPhpProject(currentDir) {
 async function detectRunningDevServer() {
   const commonPorts = [3000, 5173, 5500, 8080, 8000, 80, 5000, 4000, 3001, 5174]; // 80 for XAMPP
   const detected = [];
-  
+
   for (const port of commonPorts) {
     const inUse = await checkPortInUse(port);
     if (inUse) {
@@ -174,7 +174,7 @@ async function detectRunningDevServer() {
       }
     }
   }
-  
+
   return detected;
 }
 
@@ -244,6 +244,8 @@ async function autoDetectProject() {
 // ASCII Logo - Compatible with all OS and terminals
 function showLogo() {
   console.log("");
+  console.log("                                                                                                             ");
+  console.log("                                                                                                             ");
   console.log("8888888b.                88888888888                                  888         .d8888b.  888      8888888 ");
   console.log('888  "Y88b                   888                                      888        d88P  Y88b 888        888   ');
   console.log("888    888                   888                                      888        888    888 888        888   ");
@@ -262,17 +264,19 @@ async function main() {
   // ANSI escape codes for clear screen + cursor to top
   process.stdout.write('\x1B[2J\x1B[0f');
   console.clear(); // Fallback for terminals that don't support ANSI
-  
+
   // Show ASCII logo
   showLogo();
-  
+
   console.log(`DevTunnel v${getPackageVersion()}`);
   console.log("Share your local dev servers worldwide");
   console.log("");
   console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+  console.log("");
   console.log("Repository: https://github.com/maiz-an/DevTunnel-CLI");
   console.log("npm Package: https://www.npmjs.com/package/devtunnel-cli");
-  console.log("Website: https://maizan.me/devtunnel-cli");
+  console.log("Website: https://devtunnel-cli.vercel.app");
+  console.log("");
   console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
   console.log("");
 
@@ -288,12 +292,12 @@ async function main() {
 
   // Step 2: Check Cloudflare (bundled or system-installed)
   console.log("[2/4] Checking Cloudflare...");
-  
+
   // Import bundled cloudflared helpers
   const { setupCloudflared, hasBundledCloudflared } = await import("./setup-cloudflared.js");
-  
+
   let cloudflareAvailable = false;
-  
+
   if (hasBundledCloudflared()) {
     console.log("SUCCESS: Using bundled Cloudflare (no install needed)");
     cloudflareAvailable = true;
@@ -304,10 +308,10 @@ async function main() {
     console.log("First time setup - Downloading Cloudflare...");
     console.log("This only happens once (~40MB, 10-30 seconds)");
     console.log("");
-    
+
     try {
       const bundledPath = await setupCloudflared();
-      
+
       if (bundledPath) {
         console.log("SUCCESS: Cloudflare ready to use");
         cloudflareAvailable = true;
@@ -322,7 +326,7 @@ async function main() {
       console.log("");
     }
   }
-  
+
   // Show what's available
   if (!cloudflareAvailable) {
     console.log("DevTunnel has multi-service fallback:");
@@ -354,20 +358,20 @@ async function main() {
 
   // Step 4: Auto-detect or select project
   console.log("[4/4] Detecting project...");
-  
+
   let projectPath, projectName, devPort;
-  
+
   // Try to auto-detect project in current directory
   const autoDetected = await autoDetectProject();
-  
+
   if (autoDetected && autoDetected.port) {
     // Auto-detected project with port
     projectPath = autoDetected.path;
     projectName = autoDetected.name;
-    
+
     // Double-check: verify the port is actually in use
     const portInUse = await checkPortInUse(autoDetected.port);
-    
+
     if (!portInUse) {
       // Detected port is not actually running, check for other running servers
       const portSource =
@@ -380,7 +384,7 @@ async function main() {
               : "package.json";
       console.log(`Detected port ${autoDetected.port} (${portSource}), but no server running on that port`);
       console.log("Checking for running dev servers...");
-      
+
       const runningPorts = await detectRunningDevServer();
       if (runningPorts.length > 0) {
         if (runningPorts.length === 1) {
@@ -394,12 +398,12 @@ async function main() {
             message: "Select port:",
             choices: runningPorts.map(p => ({ title: `Port ${p}`, value: p }))
           });
-          
+
           if (!portResponse.port) {
             console.log("ERROR: No port selected");
             process.exit(1);
           }
-          
+
           devPort = portResponse.port;
         }
       } else {
@@ -411,12 +415,12 @@ async function main() {
       // Port is in use, use it
       devPort = autoDetected.port;
     }
-    
+
     console.log(`Detected project: ${projectName}`);
     console.log(`Using port: ${devPort}`);
     console.log(`Using current directory: ${projectPath}`);
     console.log("");
-    
+
     // Confirm with user
     const confirm = await prompts({
       type: "confirm",
@@ -424,22 +428,22 @@ async function main() {
       message: "Use detected project?",
       initial: true
     });
-    
+
     if (!confirm.value) {
       // User wants to select manually
       console.log("");
       console.log("Selecting project manually...");
       console.log("");
-      
+
       const selectedPath = await selectFolder();
       if (!selectedPath || selectedPath.length === 0) {
         console.log("ERROR: No folder selected");
         process.exit(1);
       }
-      
+
       projectPath = selectedPath;
       projectName = basename(selectedPath);
-      
+
       // Try to detect port for selected project (Laravel → 8000, HTML → 5500, Node from package.json)
       const selectedPackagePath = join(selectedPath, "package.json");
       const laravelSelected = detectLaravelProject(selectedPath);
@@ -449,19 +453,19 @@ async function main() {
         : htmlSelected
           ? htmlSelected.defaultPort
           : detectPortFromPackage(selectedPackagePath);
-      
+
       const portResponse = await prompts({
         type: "number",
         name: "port",
         message: "Enter your dev server port:",
         initial: detectedPort || 5173
       });
-      
+
       if (!portResponse.port) {
         console.log("ERROR: No port entered");
         process.exit(1);
       }
-      
+
       devPort = portResponse.port;
     } else {
       // User confirmed – let them keep default port or type another (e.g. HTML default 5500, can change)
@@ -479,16 +483,16 @@ async function main() {
     // Project detected but no port
     projectPath = autoDetected.path;
     projectName = autoDetected.name;
-    
+
     console.log(`Detected project: ${projectName}`);
     console.log(`Using current directory: ${projectPath}`);
     console.log("Checking for running dev servers...");
-    
+
     const runningPorts = await detectRunningDevServer();
-    
+
     if (runningPorts.length > 0) {
       console.log(`Found ${runningPorts.length} running dev server(s) on port(s): ${runningPorts.join(', ')}`);
-      
+
       if (runningPorts.length === 1) {
         devPort = runningPorts[0];
         console.log(`Using port: ${devPort}`);
@@ -500,12 +504,12 @@ async function main() {
           message: "Select port:",
           choices: runningPorts.map(p => ({ title: `Port ${p}`, value: p }))
         });
-        
+
         if (!portResponse.port) {
           console.log("ERROR: No port selected");
           process.exit(1);
         }
-        
+
         devPort = portResponse.port;
       }
     } else {
@@ -516,33 +520,33 @@ async function main() {
         message: "Enter your dev server port:",
         initial: 5173
       });
-      
+
       if (!portResponse.port) {
         console.log("ERROR: No port entered");
         process.exit(1);
       }
-      
+
       devPort = portResponse.port;
     }
-    
+
     console.log("");
   } else {
     // No auto-detection, use folder picker
     console.log("No project detected in current directory");
     console.log("Opening folder picker...");
     console.log("");
-    
+
     projectPath = await selectFolder();
-    
+
     if (!projectPath || projectPath.length === 0) {
       console.log("ERROR: No folder selected");
       process.exit(1);
     }
-    
+
     projectName = basename(projectPath);
     console.log(`Selected: ${projectPath}`);
     console.log("");
-    
+
     // Try to detect port for selected project (Laravel → 8000, HTML → 5500, PHP → 80, Node from package.json)
     const selectedPackagePath = join(projectPath, "package.json");
     const laravelSelected = detectLaravelProject(projectPath);
@@ -555,30 +559,30 @@ async function main() {
         : phpSelected
           ? phpSelected.defaultPort  // 80
           : detectPortFromPackage(selectedPackagePath);
-    
+
     // Check for running servers
     const runningPorts = await detectRunningDevServer();
-    
+
     let initialPort = detectedPort || 5173;
     if (runningPorts.length > 0 && !detectedPort) {
       initialPort = runningPorts[0];
     }
-    
+
     const portResponse = await prompts({
       type: "number",
       name: "port",
       message: "Enter your dev server port:",
       initial: initialPort
     });
-    
+
     if (!portResponse.port) {
       console.log("ERROR: No port entered");
       process.exit(1);
     }
-    
+
     devPort = portResponse.port;
   }
-  
+
   console.log("");
   const proxyPort = devPort + 1000; // Use port 1000 higher for proxy
 
@@ -608,7 +612,7 @@ async function main() {
       stdio: "pipe",
       shell: false
     });
-    staticServerProcess.on("error", () => {});
+    staticServerProcess.on("error", () => { });
     const ready = await waitForServerReady(devPort, 10000);
     if (!ready) {
       if (staticServerProcess) staticServerProcess.kill();

package/src/utils/pages/index.html

@@ -10,17 +10,17 @@
     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">
   <meta name="robots" content="index, follow">
-  <link rel="canonical" href="https://maizan.me/devtunnel-cli/">
+  <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">
-  <meta property="og:url" content="https://maizan.me/devtunnel-cli/">
+  <meta property="og:url" content="https://devtunnel-cli.vercel.app/">
   <meta property="og:type" content="website">
-  <meta property="og:image" content="https://maizan.me/devtunnel-cli/og-image.png">
+  <meta property="og:image" content="https://devtunnel-cli.vercel.app/og-image.png">
   <meta name="twitter:card" content="summary_large_image">
   <meta name="twitter:title" content="DevTunnel - Share Local Servers Worldwide">
   <meta name="twitter:description" content="Zero configuration tunnel for any framework">
-  <meta name="twitter:image" content="https://maizan.me/devtunnel-cli/og-image.png">
+  <meta name="twitter:image" content="https://devtunnel-cli.vercel.app/og-image.png">
   <title>DevTunnel - Share Local Servers Worldwide</title>
   <style>
     body {
@@ -77,7 +77,7 @@
 
   <div class="links">
     <a href="https://www.npmjs.com/package/devtunnel-cli" class="badge">📦 npm Package</a>
-    <a href="https://maizan.me/devtunnel-cli" class="badge">🌐 Website</a>
+    <a href="https://devtunnel-cli.vercel.app" class="badge">🌐 Website</a>
     <a href="https://github.com/maiz-an/DevTunnel-CLI" class="badge">💻 GitHub</a>
   </div>
 
@@ -106,13 +106,13 @@ devtunnel-cli</code></pre>
   <h2>🔗 Links</h2>
   <ul>
     <li><a href="https://www.npmjs.com/package/devtunnel-cli">npm Package (devtunnel-cli)</a></li>
-    <li><a href="https://maizan.me/devtunnel-cli">Official Website</a></li>
+    <li><a href="https://devtunnel-cli.vercel.app">Official Website</a></li>
     <li><a href="https://github.com/maiz-an/DevTunnel-CLI">GitHub Repository</a></li>
     <li><a href="https://github.com/maiz-an/DevTunnel-CLI/issues">Report Issues</a></li>
   </ul>
 
   <hr>
-  <p><small>Version 3.0.35 | Made with ❤︎ for developers worldwide</small></p>
+  <p><small>Version 3.0.38 | Made with ❤︎ for developers worldwide</small></p>
 </body>
 
 </html>