devtunnel-cli 3.0.0

package/README.md

@@ -0,0 +1,82 @@
+# 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)
+
+🌐 **Website:** [devtunnel.vercel.app](https://devtunnel.vercel.app)
+
+---
+
+## ⚡ Quick Start
+
+### 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
+
+---
+
+## 💡 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.0** | Made with ❤️ for developers worldwide

package/bin/README.md

@@ -0,0 +1,40 @@
+# Bundled Binaries
+
+This folder contains platform-specific binaries that are automatically downloaded on first run.
+
+## Structure
+
+```
+bin/
+├── win32/
+│   └── cloudflared.exe    (Windows binary)
+├── darwin/
+│   └── cloudflared        (macOS binary)
+└── linux/
+    └── cloudflared        (Linux binary)
+```
+
+## Automatic Setup
+
+When you run DevTunnel for the first time, it will:
+1. Detect your operating system
+2. Download the appropriate Cloudflare binary (~40MB)
+3. Save it to this folder
+4. Use it for all future runs
+
+**No manual installation required!**
+
+## Manual Setup (Optional)
+
+If you want to pre-download binaries:
+
+```bash
+node src/core/setup-cloudflared.js
+```
+
+## Notes
+
+- These files are in `.gitignore` (not pushed to GitHub)
+- Downloaded automatically on first run
+- Falls back to system-installed cloudflared if download fails
+- Version: Cloudflare 2024.8.2 (latest stable)

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "devtunnel-cli",
+  "version": "3.0.0",
+  "type": "module",
+  "description": "Share local dev servers worldwide - Zero config tunnel for any framework",
+  "main": "src/core/start.js",
+  "bin": {
+    "devtunnel": "src/core/RUN.js"
+  },
+  "scripts": {
+    "start": "node src/core/RUN.js",
+    "dev": "node src/core/RUN.js",
+    "run": "node src/core/RUN.js",
+    "tunnel": "node src/core/index.js"
+  },
+  "keywords": [
+    "tunnel",
+    "devtunnel",
+    "cloudflare",
+    "ngrok",
+    "localtunnel",
+    "dev-server",
+    "share",
+    "public-url",
+    "vite",
+    "react",
+    "nextjs",
+    "nestjs",
+    "express",
+    "backend",
+    "frontend",
+    "proxy",
+    "development",
+    "localhost",
+    "port-forwarding"
+  ],
+  "author": "maiz",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/maiz-an/DevTunnel.git"
+  },
+  "bugs": {
+    "url": "https://github.com/maiz-an/DevTunnel/issues"
+  },
+  "homepage": "https://devtunnel.vercel.app",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "http-proxy": "^1.18.1",
+    "localtunnel": "^2.0.2",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {}
+}

package/src/core/RUN.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+
+// Universal Node.js Launcher - Works on ALL platforms!
+import { spawn } from "child_process";
+import { platform } from "os";
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+console.log("\n🚀 DevTunnel - Universal Launcher\n");
+console.log(`📍 Platform detected: ${platform()}\n`);
+
+// Start the main app
+const startPath = join(__dirname, "src", "core", "start.js");
+const child = spawn("node", [startPath], {
+  stdio: "inherit",
+  shell: false
+});
+
+child.on("error", (error) => {
+  console.error("❌ Error starting app:", error.message);
+  process.exit(1);
+});
+
+child.on("close", (code) => {
+  if (code !== 0) {
+    console.log(`\n⚠️  Process exited with code ${code}`);
+  }
+  process.exit(code || 0);
+});
+
+// Handle Ctrl+C
+process.on("SIGINT", () => {
+  child.kill("SIGINT");
+});
+
+process.on("SIGTERM", () => {
+  child.kill("SIGTERM");
+});

package/src/core/index.js

@@ -0,0 +1,394 @@
+import { spawn } from "child_process";
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+
+// Get current directory (needed for ESM)
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Get port and project path from command line arguments
+const PORT = parseInt(process.argv[2]);
+const PROJECT_NAME = process.argv[3] || `Project (Port ${PORT})`;
+const PROJECT_PATH = process.argv[4] || process.cwd();
+
+// Import bundled cloudflared helpers
+const { getBinaryPath, hasBundledCloudflared } = await import("./setup-cloudflared.js");
+
+// No custom prefix - Cloudflare generates random URLs
+
+if (!PORT || isNaN(PORT) || PORT < 1 || PORT > 65535) {
+  console.error("❌ Invalid port number!");
+  console.error("Usage: node index.js <port> [projectName]");
+  console.error("Example: node index.js 5173");
+  process.exit(1);
+}
+
+let tunnelProcess;
+let currentTunnelType = null;
+
+console.log("╔════════════════════════════════════════════╗");
+console.log("║           🌐 DevTunnel v3.0               ║");
+console.log("╠════════════════════════════════════════════╣");
+console.log(`║  📦 ${PROJECT_NAME.padEnd(38)} ║`);
+console.log(`║  🔌 Port: ${PORT.toString().padEnd(34)} ║`);
+console.log("╚════════════════════════════════════════════╝\n");
+console.log("💡 Ensure dev server is running on port " + PORT + "\n");
+
+// Check if project is Vite and auto-fix config for Cloudflare
+async function fixViteConfigForCloudflare() {
+  const viteConfigPath = join(PROJECT_PATH, "vite.config.js");
+  const viteConfigTsPath = join(PROJECT_PATH, "vite.config.ts");
+  
+  let configPath = null;
+  if (existsSync(viteConfigPath)) configPath = viteConfigPath;
+  else if (existsSync(viteConfigTsPath)) configPath = viteConfigTsPath;
+  
+  if (!configPath) return false;
+  
+  try {
+    let config = readFileSync(configPath, "utf-8");
+    
+    // Check if already configured for external access
+    if (config.includes("host: true") || config.includes("host:true") || 
+        config.includes("host: '0.0.0.0'") || config.includes('host: "0.0.0.0"') ||
+        config.includes('host:"0.0.0.0"') || config.includes("host:'0.0.0.0'")) {
+      console.log("✅ Vite config already allows external access\n");
+      return true;
+    }
+    
+    console.log("📝 Auto-fixing Vite config for tunnel access...");
+    
+    let newConfig = config;
+    
+    // Case 1: Has existing server config
+    if (config.includes("server:") || config.includes("server :")) {
+      // Add host inside existing server block
+      newConfig = config.replace(
+        /(server\s*:\s*\{)/,
+        `$1\n    host: true, // Allow tunnel access`
+      );
+    }
+    // Case 2: No server config, add it after defineConfig({
+    else if (config.includes("defineConfig")) {
+      newConfig = config.replace(
+        /defineConfig\(\s*\{/,
+        `defineConfig({\n  server: {\n    host: true, // Allow tunnel access\n  },`
+      );
+    }
+    // Case 3: Simple export default object
+    else if (config.includes("export default {")) {
+      newConfig = config.replace(
+        /export\s+default\s+\{/,
+        `export default {\n  server: {\n    host: true, // Allow tunnel access\n  },`
+      );
+    }
+    
+    if (newConfig !== config) {
+      // Backup original
+      writeFileSync(configPath + ".backup", config);
+      writeFileSync(configPath, newConfig);
+      console.log("\n" + "=".repeat(60));
+      console.log("✅ VITE CONFIG UPDATED!");
+      console.log("=".repeat(60));
+      console.log("⚠️  IMPORTANT: You MUST restart your dev server now!");
+      console.log("   1. Stop your dev server (Ctrl+C)");
+      console.log("   2. Run: npm run dev");
+      console.log("   3. Then run this tool again");
+      console.log("\nBackup saved: " + configPath + ".backup");
+      console.log("=".repeat(60) + "\n");
+      
+      // Wait for user to acknowledge
+      console.log("Press Ctrl+C to exit and restart your dev server...\n");
+      await new Promise(resolve => setTimeout(resolve, 60000)); // Wait 60 seconds
+      return true;
+    }
+    
+    console.log("⚠️  Could not auto-fix config. You may need to manually add:\n");
+    console.log("   server: { host: true }\n");
+    return false;
+  } catch (error) {
+    console.log("⚠️  Could not read Vite config:", error.message);
+    return false;
+  }
+}
+
+// Get cloudflared command (bundled or system)
+function getCloudflaredCommand() {
+  return hasBundledCloudflared() ? getBinaryPath() : "cloudflared";
+}
+
+// Tunnel services to try in order (Cloudflare first - no password, fast)
+const TUNNEL_SERVICES = [
+  {
+    name: "Cloudflare",
+    get command() {
+      return getCloudflaredCommand();
+    },
+    args: ["tunnel", "--url", `http://localhost:${PORT}`],
+    available: async () => {
+      try {
+        const cmd = getCloudflaredCommand();
+        const result = spawn(cmd, ["--version"], { shell: true, stdio: "pipe" });
+        return new Promise((resolve) => {
+          result.on("close", (code) => resolve(code === 0));
+          result.on("error", () => resolve(false));
+        });
+      } catch {
+        return false;
+      }
+    },
+    needsViteFix: true
+  },
+  {
+    name: "Ngrok",
+    command: "ngrok",
+    args: ["http", PORT.toString()],
+    available: async () => {
+      try {
+        const result = spawn("ngrok", ["--version"], { shell: true, stdio: "pipe" });
+        return new Promise((resolve) => {
+          result.on("close", (code) => resolve(code === 0));
+          result.on("error", () => resolve(false));
+        });
+      } catch {
+        return false;
+      }
+    },
+    needsViteFix: true
+  },
+  {
+    name: "LocalTunnel",
+    command: "node",
+    args: [join(__dirname, "tunnel-helpers.js"), "localtunnel", PORT.toString()],
+    available: async () => {
+      try {
+        await import("localtunnel");
+        return true;
+      } catch {
+        return false;
+      }
+    },
+    needsViteFix: false,
+    warning: "⚠️  Note: LocalTunnel shows a password page on first visit (uses your public IP)"
+  }
+];
+
+// Try each tunnel service
+async function tryTunnelServices() {
+  console.log("🔍 Checking available tunnel services...\n");
+
+  let hasCloudflare = false;
+  
+  // Check if Cloudflare is available
+  for (const service of TUNNEL_SERVICES) {
+    if (service.name === "Cloudflare" && await service.available()) {
+      hasCloudflare = true;
+      break;
+    }
+  }
+  
+  // Show tip if Cloudflare not installed
+  if (!hasCloudflare) {
+    console.log("💡 TIP: Install Cloudflare for best experience (no password, fastest)");
+    console.log("   → winget install Cloudflare.cloudflared\n");
+  }
+
+  for (const service of TUNNEL_SERVICES) {
+    const available = await service.available();
+    
+    if (available) {
+      console.log(`✅ ${service.name} is available`);
+      
+      // Show warning if exists
+      if (service.warning) {
+        console.log(service.warning);
+      }
+      
+      // Skip Vite auto-fix - using proxy server instead
+      
+      console.log(`🌐 Starting ${service.name} tunnel...\n`);
+      
+      currentTunnelType = service.name;
+      tunnelProcess = spawn(service.command, service.args, {
+        shell: true,
+        stdio: "pipe"
+      });
+
+      setupTunnelHandlers(service.name);
+      
+      // Wait a bit to see if tunnel starts successfully
+      await new Promise(resolve => setTimeout(resolve, 3000));
+      
+      // Check if process is still running
+      if (tunnelProcess && !tunnelProcess.killed) {
+        console.log(`\n✅ Successfully connected via ${service.name}!`);
+        if (service.name === "LocalTunnel") {
+          console.log("💡 First-time visitors need to enter tunnel password (your public IP)");
+          console.log("💡 Get password at: https://loca.lt/mytunnelpassword\n");
+        }
+        console.log("Press Ctrl+C to stop the tunnel\n");
+        return true;
+      }
+    } else {
+      console.log(`⚠️  ${service.name} not available`);
+    }
+  }
+
+  console.log("\n❌ No tunnel services available!");
+  console.log("\n💡 Recommended: Install Cloudflare (fastest, no password):");
+  console.log("   winget install Cloudflare.cloudflared");
+  console.log("\n💡 Or install Ngrok:");
+  console.log("   Download from: https://ngrok.com/download");
+  console.log("\n💡 LocalTunnel is already installed but may require restart");
+  process.exit(1);
+}
+
+function setupTunnelHandlers(serviceName) {
+  if (!tunnelProcess) return;
+
+  tunnelProcess.stdout.on("data", (data) => {
+    const output = data.toString();
+    const lines = output.split("\n");
+    
+    lines.forEach(line => {
+      const trimmed = line.trim();
+      if (!trimmed) return;
+
+      // Extract URLs from different services
+      if (serviceName === "Cloudflare") {
+        // Look for trycloudflare.com URL
+        if (trimmed.includes("trycloudflare.com")) {
+          // Extract just the URL
+          const urlMatch = trimmed.match(/(https?:\/\/[^\s]+trycloudflare\.com[^\s]*)/);
+          if (urlMatch) {
+            const url = urlMatch[1];
+            const minWidth = 60;
+            const urlLength = url.length + 4; // 2 spaces on each side + "║"
+            const boxWidth = Math.max(minWidth, urlLength);
+            
+            console.log("\n╔" + "═".repeat(boxWidth) + "╗");
+            const headerText = "✅ PUBLIC URL";
+            const headerPadding = boxWidth - headerText.length;
+            console.log("║ " + headerText + " ".repeat(Math.max(0, headerPadding)) + "║");
+            console.log("╠" + "═".repeat(boxWidth) + "╣");
+            const urlPadding = boxWidth - url.length;
+            console.log("║ " + url + " ".repeat(Math.max(0, urlPadding)) + "║");
+            console.log("╠" + "═".repeat(boxWidth) + "╣");
+            const shareText = "💡 Share this URL with anyone!";
+            const sharePadding = boxWidth - shareText.length;
+            console.log("║ " + shareText + " ".repeat(Math.max(0, sharePadding)) + "║");
+            console.log("╚" + "═".repeat(boxWidth) + "╝\n");
+          }
+        }
+        // Show other important messages (but filter out most INF/WRN logs)
+        else if (!trimmed.includes("INF") && !trimmed.includes("WRN") && !trimmed.includes("+---")) {
+          // Don't show these lines
+        }
+      } else if (serviceName === "Ngrok") {
+        if (trimmed.includes("https://") || trimmed.includes("http://")) {
+          const url = trimmed;
+          const minWidth = 60;
+          const urlLength = url.length + 4;
+          const boxWidth = Math.max(minWidth, urlLength);
+          
+          console.log("\n╔" + "═".repeat(boxWidth) + "╗");
+          const headerText = "✅ PUBLIC URL";
+          const headerPadding = boxWidth - headerText.length;
+          console.log("║ " + headerText + " ".repeat(Math.max(0, headerPadding)) + "║");
+          console.log("╠" + "═".repeat(boxWidth) + "╣");
+          const urlPadding = boxWidth - url.length;
+          console.log("║ " + url + " ".repeat(Math.max(0, urlPadding)) + "║");
+          console.log("╚" + "═".repeat(boxWidth) + "╝\n");
+        }
+      } else {
+        // LocalTunnel or other services
+        if (trimmed.includes("your url is:")) {
+          const urlMatch = trimmed.match(/https?:\/\/[^\s]+/);
+          if (urlMatch) {
+            const url = urlMatch[0];
+            const minWidth = 60;
+            const urlLength = url.length + 4;
+            const boxWidth = Math.max(minWidth, urlLength);
+            
+            console.log("\n╔" + "═".repeat(boxWidth) + "╗");
+            const headerText = "✅ PUBLIC URL";
+            const headerPadding = boxWidth - headerText.length;
+            console.log("║ " + headerText + " ".repeat(Math.max(0, headerPadding)) + "║");
+            console.log("╠" + "═".repeat(boxWidth) + "╣");
+            const urlPadding = boxWidth - url.length;
+            console.log("║ " + url + " ".repeat(Math.max(0, urlPadding)) + "║");
+            console.log("╚" + "═".repeat(boxWidth) + "╝\n");
+          }
+        }
+      }
+    });
+  });
+
+  tunnelProcess.stderr.on("data", (data) => {
+    const output = data.toString();
+    
+    // For Cloudflare, check if URL is in stderr (sometimes it is)
+    if (serviceName === "Cloudflare" && output.includes("trycloudflare.com")) {
+      const urlMatch = output.match(/(https?:\/\/[^\s]+trycloudflare\.com[^\s]*)/);
+      if (urlMatch) {
+        const url = urlMatch[1];
+        const minWidth = 60;
+        const urlLength = url.length + 4;
+        const boxWidth = Math.max(minWidth, urlLength);
+        
+        console.log("\n╔" + "═".repeat(boxWidth) + "╗");
+        const headerText = "✅ PUBLIC URL";
+        const headerPadding = boxWidth - headerText.length;
+        console.log("║ " + headerText + " ".repeat(Math.max(0, headerPadding)) + "║");
+        console.log("╠" + "═".repeat(boxWidth) + "╣");
+        const urlPadding = boxWidth - url.length;
+        console.log("║ " + url + " ".repeat(Math.max(0, urlPadding)) + "║");
+        console.log("╚" + "═".repeat(boxWidth) + "╝\n");
+      }
+    }
+    
+    // Only show errors, not info messages
+    if (!output.includes("INF") && !output.includes("WRN")) {
+      const trimmed = output.trim();
+      if (trimmed && !trimmed.includes("originCertPath")) {
+        console.error(`⚠️  ${trimmed}`);
+      }
+    }
+  });
+
+  tunnelProcess.on("error", (error) => {
+    console.error(`\n❌ ${serviceName} error:`, error.message);
+  });
+
+  tunnelProcess.on("exit", (code) => {
+    if (code !== 0 && code !== null) {
+      console.error(`\n⚠️  ${serviceName} exited with code ${code}`);
+    }
+  });
+}
+
+// Handle cleanup on exit
+function cleanup() {
+  console.log("\n\n🛑 Shutting down tunnel...");
+  try {
+    if (tunnelProcess) {
+      tunnelProcess.kill();
+    }
+  } catch (e) {
+    // Ignore errors during cleanup
+  }
+  setTimeout(() => {
+    process.exit(0);
+  }, 500);
+}
+
+process.on("SIGINT", cleanup);
+process.on("SIGTERM", cleanup);
+
+// Start trying tunnel services
+tryTunnelServices().catch((error) => {
+  console.error("Error:", error);
+  process.exit(1);
+});

package/src/core/proxy-server.js

@@ -0,0 +1,72 @@
+import http from "http";
+import httpProxy from "http-proxy";
+
+// Get ports from command line
+const TARGET_PORT = parseInt(process.argv[2]); // Your dev server port
+const PROXY_PORT = parseInt(process.argv[3]);  // Port for tunnel to connect to
+const PROJECT_NAME = process.argv[4] || "Project";
+
+if (!TARGET_PORT || !PROXY_PORT) {
+  console.error("Usage: node proxy-server.js <target-port> <proxy-port> [project-name]");
+  process.exit(1);
+}
+
+// Create proxy
+const proxy = httpProxy.createProxyServer({
+  target: `http://localhost:${TARGET_PORT}`,
+  changeOrigin: true,
+  ws: true, // Enable WebSocket proxying (for HMR)
+  xfwd: true
+});
+
+// Handle proxy errors
+proxy.on("error", (err, req, res) => {
+  console.error("❌ Proxy error:", err.message);
+  if (res.writeHead) {
+    res.writeHead(502, { "Content-Type": "text/plain" });
+    res.end("Bad Gateway: Could not connect to your dev server.\nMake sure it's running on port " + TARGET_PORT);
+  }
+});
+
+// Create HTTP server
+const server = http.createServer((req, res) => {
+  // Add CORS headers
+  res.setHeader("Access-Control-Allow-Origin", "*");
+  res.setHeader("Access-Control-Allow-Methods", "GET, POST, PUT, DELETE, OPTIONS");
+  res.setHeader("Access-Control-Allow-Headers", "*");
+  
+  if (req.method === "OPTIONS") {
+    res.writeHead(200);
+    res.end();
+    return;
+  }
+  
+  // Proxy the request
+  proxy.web(req, res);
+});
+
+// Handle WebSocket upgrade (for Vite HMR)
+server.on("upgrade", (req, socket, head) => {
+  proxy.ws(req, socket, head);
+});
+
+// Start server
+server.listen(PROXY_PORT, () => {
+  console.log("╔════════════════════════════════════════════╗");
+  console.log("║       🔗 DevTunnel Proxy Server           ║");
+  console.log("╠════════════════════════════════════════════╣");
+  console.log(`║  📦 Project: ${PROJECT_NAME.padEnd(28)} ║`);
+  console.log(`║  🎯 Dev Server: http://localhost:${TARGET_PORT.toString().padEnd(7)} ║`);
+  console.log(`║  🔌 Proxy Port: ${PROXY_PORT.toString().padEnd(28)} ║`);
+  console.log("╠════════════════════════════════════════════╣");
+  console.log("║  ✅ Ready! Tunnel will connect to proxy   ║");
+  console.log("║  💡 No config changes needed              ║");
+  console.log("╚════════════════════════════════════════════╝\n");
+});
+
+// Handle shutdown
+process.on("SIGINT", () => {
+  console.log("\n\n🛑 Shutting down proxy...");
+  server.close();
+  process.exit(0);
+});