devtunnel-cli 3.0.44 → 3.0.45

package/README.md

@@ -1,141 +1,141 @@
-# DevTunnel-CLI 🚀
-
-**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-CLI)
-[![npm version](https://img.shields.io/npm/v/devtunnel-cli)](https://www.npmjs.com/package/devtunnel-cli)
-
-🌐 **Website:** [devtunnel-cli.vercel.app](https://devtunnel-cli.vercel.app) | 📦 **npm:** [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli) | 💻 **GitHub:** [maiz-an/DevTunnel-CLI](https://github.com/maiz-an/DevTunnel-CLI)
-
-**Install (global):** `npm i -g devtunnel-cli`
-
----
-
-## 🎯 Purpose & Scope
-
-DevTunnel-CLI is designed for **DEVELOPMENT**, **TESTING**, **DEMOS**, and **WEBHOOK DEBUGGING**. It provides fast, frictionless access to your local dev servers from anywhere.
-
-DevTunnel-CLI is built for developers who need instant public URLs to share work-in-progress, test on mobile devices, demo features to clients, or debug webhooks from third-party services.
-
----
-
-## ⚡ Quick Start
-
-### Step-by-Step Guide
-
-**1. Install DevTunnel (one-time setup):**
-
-```bash
-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)
-# OR  XAMPP / Live Server (PHP/HTML)
-# HTML: optional — DevTunnel can start a built-in server
-```
-
-**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!
-```
-
-**That's it!** DevTunnel auto-detects Node, Laravel, HTML, and PHP/XAMPP projects.
-
----
-
-## ✨ 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** - 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/>)
-- 🔄 **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
-
----
-
-## 💡 How to Use
-
-**Important:** Run `devtunnel-cli` from the same directory as your project!
-
-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
-5. **Run DevTunnel**: `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
-npm run dev
-
-# Terminal 2 - same directory
-cd my-react-app
-devtunnel-cli
-```
-
-**Works with:** Vite, React, Next.js, Express, NestJS, Laravel, plain HTML, PHP/XAMPP, and any HTTP/HTTPS server.
-
----
-
-## 📖 Documentation
-
-- [Features](docs/FEATURES.md)
-- [Troubleshooting](docs/TROUBLESHOOTING.md)
-- [Contributing](docs/CONTRIBUTING.md)
-- [License](docs/LICENSE)
-
----
-
-## 🛠️ 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)
-
----
-
-**Latest on [npm](https://www.npmjs.com/package/devtunnel-cli)** | Made with ❤︎ for developers worldwide
-
----
-
-## 🔍 Search keywords
-
-Find this project as: **DevTunnel**, **devtunnel**, **dev-tunnel**, **Dev-Tunnel**, **DevTunnel-CLI**, **devtunnel-cli**, **dev-tunnel-cli**, **Dev-Tunnel-CLI**. npm (install here): [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli) · Docs: [devtunnel-cli.vercel.app](https://devtunnel-cli.vercel.app) · GitHub: [maiz-an/DevTunnel-CLI](https://github.com/maiz-an/DevTunnel-CLI).
-
----
-
-## 📦 Links
-
-- **Website**: [devtunnel-cli.vercel.app](https://devtunnel-cli.vercel.app)
-- **npm**: [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli)
-- **GitHub**: [maiz-an/DevTunnel-CLI](https://github.com/maiz-an/DevTunnel-CLI)
-- **Issues**: [GitHub Issues](https://github.com/maiz-an/DevTunnel-CLI/issues)
+# DevTunnel-CLI 🚀
+
+**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-CLI)
+[![npm version](https://img.shields.io/npm/v/devtunnel-cli)](https://www.npmjs.com/package/devtunnel-cli)
+
+🌐 **Website:** [devtunnel-cli.vercel.app](https://devtunnel-cli.vercel.app) | 📦 **npm:** [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli) | 💻 **GitHub:** [maiz-an/DevTunnel-CLI](https://github.com/maiz-an/DevTunnel-CLI)
+
+**Install (global):** `npm i -g devtunnel-cli`
+
+---
+
+## 🎯 Purpose & Scope
+
+DevTunnel-CLI is designed for **DEVELOPMENT**, **TESTING**, **DEMOS**, and **WEBHOOK DEBUGGING**. It provides fast, frictionless access to your local dev servers from anywhere.
+
+DevTunnel-CLI is built for developers who need instant public URLs to share work-in-progress, test on mobile devices, demo features to clients, or debug webhooks from third-party services.
+
+---
+
+## ⚡ Quick Start
+
+### Step-by-Step Guide
+
+**1. Install DevTunnel (one-time setup):**
+
+```bash
+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)
+# OR  XAMPP / Live Server (PHP/HTML)
+# HTML: optional — DevTunnel can start a built-in server
+```
+
+**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!
+```
+
+**That's it!** DevTunnel auto-detects Node, Laravel, HTML, and PHP/XAMPP projects.
+
+---
+
+## ✨ 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** - 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/>)
+- 🔄 **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
+
+---
+
+## 💡 How to Use
+
+**Important:** Run `devtunnel-cli` from the same directory as your project!
+
+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
+5. **Run DevTunnel**: `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
+npm run dev
+
+# Terminal 2 - same directory
+cd my-react-app
+devtunnel-cli
+```
+
+**Works with:** Vite, React, Next.js, Express, NestJS, Laravel, plain HTML, PHP/XAMPP, and any HTTP/HTTPS server.
+
+---
+
+## 📖 Documentation
+
+- [Features](docs/FEATURES.md)
+- [Troubleshooting](docs/TROUBLESHOOTING.md)
+- [Contributing](docs/CONTRIBUTING.md)
+- [License](docs/LICENSE)
+
+---
+
+## 🛠️ 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)
+
+---
+
+**Latest on [npm](https://www.npmjs.com/package/devtunnel-cli)** | Made with ❤︎ for developers worldwide
+
+---
+
+## 🔍 Search keywords
+
+Find this project as: **DevTunnel**, **devtunnel**, **dev-tunnel**, **Dev-Tunnel**, **DevTunnel-CLI**, **devtunnel-cli**, **dev-tunnel-cli**, **Dev-Tunnel-CLI**. npm (install here): [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli) · Docs: [devtunnel-cli.vercel.app](https://devtunnel-cli.vercel.app) · GitHub: [maiz-an/DevTunnel-CLI](https://github.com/maiz-an/DevTunnel-CLI).
+
+---
+
+## 📦 Links
+
+- **Website**: [devtunnel-cli.vercel.app](https://devtunnel-cli.vercel.app)
+- **npm**: [devtunnel-cli](https://www.npmjs.com/package/devtunnel-cli)
+- **GitHub**: [maiz-an/DevTunnel-CLI](https://github.com/maiz-an/DevTunnel-CLI)
+- **Issues**: [GitHub Issues](https://github.com/maiz-an/DevTunnel-CLI/issues)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtunnel-cli",
-  "version": "3.0.44",
+  "version": "3.0.45",
   "type": "module",
   "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",
@@ -18,7 +18,8 @@
     "tunnel": "node src/core/index.js",
     "sync-version": "node sync-version.js",
     "test": "node -e \"console.log('ok')\"",
-    "prepublishOnly": "npm test"
+    "prepublishOnly": "npm test",
+    "postinstall": "node src/utils/postinstall-global-check.cjs"
   },
   "keywords": [
     "DevTunnel-CLI",

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.44";
+      return pkg.version || "3.0.45";
     }
   } catch (err) { }
-  return "3.0.44";
+  return "3.0.45";
 }
 
 // Helper to run command

package/src/utils/pages/index.html

@@ -112,7 +112,7 @@ devtunnel-cli</code></pre>
   </ul>
 
   <hr>
-  <p><small>Version <span id="pkg-version">3.0.44</span> | Made with ❤︎ for developers worldwide</small></p>
+  <p><small>Version <span id="pkg-version">3.0.45</span> | Made with ❤︎ for developers worldwide</small></p>
 
   <script>
     (async function () {

package/src/utils/postinstall-global-check.cjs

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+'use strict';
+// Warn if installed locally (without -g). For security, devtunnel-cli should be installed globally.
+const path = require('path');
+try {
+  const dir = __dirname; // e.g. .../node_modules/devtunnel-cli/src/utils
+  const inNodeModules = dir.includes('node_modules');
+  const npmPrefix = process.env.npm_config_prefix || (process.platform === 'win32' ? (process.env.APPDATA || '') + '\\npm' : '/usr/local');
+  const globalNodeModules = path.join(npmPrefix, 'node_modules');
+  const isGlobal = inNodeModules && (dir.startsWith(globalNodeModules) || path.resolve(dir).startsWith(path.resolve(globalNodeModules)));
+  if (inNodeModules && !isGlobal) {
+    console.error('\n  \x1b[33mWARN: devtunnel-cli should be installed globally to avoid vulnerabilities.\x1b[0m');
+    console.error('  Run: \x1b[1mnpm i -g devtunnel-cli\x1b[0m\n');
+  }
+} catch (e) { /* ignore */ }