webtun 1.4.1 → 1.4.2

package/README.md

@@ -106,7 +106,17 @@ npx webtun --tunnel               # With Cloudflare Tunnel
 npx webtun -p 4000 -t             # Port 4000 + tunnel
 ```
 
-**Note:** `node-pty` requires build tools on first install:
+**Note:** npm 12+ blocks install scripts by default. Allow them for `node-pty` (native module):
+```bash
+# Allow scripts once during install
+npm install -g --allow-scripts=webtun,node-pty webtun
+
+# Or allow globally (one-time setup)
+npm config set allow-scripts=webtun,node-pty --location=user
+npm install -g webtun
+```
+
+Build tools are also required (for compiling native modules):
 ```bash
 # Debian/Ubuntu
 sudo apt-get install -y python3 make g++

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webtun",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Self-hosted web terminal with Cloudflare Tunnel, file explorer, and PWA support",
   "author": {
     "name": "Gaurang Patel",

package/server.js

@@ -20,11 +20,22 @@ let pty;
 try {
   pty = require('node-pty');
 } catch (e) {
-  console.error('\n  Error: node-pty failed to load. Terminal functionality requires native build tools.');
-  console.error('  Install build tools and reinstall:');
+  console.error('');
+  console.error('  Error: node-pty native module not found.');
+  console.error('');
+  console.error('  npm 12+ blocks install scripts by default. To fix:');
+  console.error('');
+  console.error('  Option 1 — Allow scripts once:');
+  console.error('    npm install -g --allow-scripts=webtun,node-pty webtun');
+  console.error('');
+  console.error('  Option 2 — Allow scripts globally (one-time):');
+  console.error('    npm config set allow-scripts=webtun,node-pty --location=user');
+  console.error('    npm install -g webtun');
+  console.error('');
+  console.error('  Option 3 — If building from source, install build tools first:');
   console.error('    Linux:  sudo apt-get install -y python3 make g++');
   console.error('    macOS:  xcode-select --install');
-  console.error('  Then reinstall: npm install webtun\n');
+  console.error('');
   process.exit(1);
 }
 const multer = require('multer');