portless 0.2.0 → 0.2.2

package/dist/cli.js

@@ -11,7 +11,7 @@ import chalk from "chalk";
 import * as fs from "fs";
 import * as path from "path";
 import * as readline from "readline";
-import { spawn, spawnSync } from "child_process";
+import { execSync, spawn, spawnSync } from "child_process";
 
 // src/cli-utils.ts
 import * as net from "net";
@@ -85,6 +85,18 @@ function readProxyPort() {
     return DEFAULT_PROXY_PORT;
   }
 }
+function findPidOnPort(port) {
+  try {
+    const output = execSync(`lsof -ti tcp:${port} -sTCP:LISTEN`, {
+      encoding: "utf-8",
+      timeout: 5e3
+    });
+    const pid = parseInt(output.trim().split("\n")[0], 10);
+    return isNaN(pid) ? null : pid;
+  } catch {
+    return null;
+  }
+}
 async function waitForProxy(proxyPort, maxAttempts = 20, intervalMs = 250) {
   const port = proxyPort ?? readProxyPort();
   for (let i = 0; i < maxAttempts; i++) {
@@ -199,11 +211,40 @@ function startProxyServer(proxyPort) {
 }
 async function stopProxy() {
   const pidPath = store.pidPath;
+  const proxyPort = readProxyPort();
   if (!fs.existsSync(pidPath)) {
-    console.log(chalk.yellow("Proxy is not running."));
+    if (await isProxyRunning(proxyPort)) {
+      console.log(chalk.yellow(`PID file is missing but port ${proxyPort} is still in use.`));
+      const pid = findPidOnPort(proxyPort);
+      if (pid !== null) {
+        try {
+          process.kill(pid, "SIGTERM");
+          try {
+            fs.unlinkSync(PROXY_PORT_PATH);
+          } catch {
+          }
+          console.log(chalk.green(`Killed process ${pid}. Proxy stopped.`));
+        } catch (err) {
+          if (isErrnoException(err) && err.code === "EPERM") {
+            console.error(chalk.red("Permission denied. The proxy runs as root."));
+            console.log(chalk.blue("Use: sudo portless proxy stop"));
+          } else {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(chalk.red("Failed to stop proxy:"), message);
+          }
+        }
+      } else if (process.getuid?.() !== 0) {
+        console.error(chalk.red("Permission denied. The proxy likely runs as root."));
+        console.log(chalk.blue("Use: sudo portless proxy stop"));
+      } else {
+        console.error(chalk.red(`Could not identify the process on port ${proxyPort}.`));
+        console.log(chalk.blue(`Try: sudo kill "$(lsof -ti tcp:${proxyPort})"`));
+      }
+    } else {
+      console.log(chalk.yellow("Proxy is not running."));
+    }
     return;
   }
-  const proxyPort = readProxyPort();
   try {
     const pid = parseInt(fs.readFileSync(pidPath, "utf-8"), 10);
     if (isNaN(pid)) {
@@ -326,6 +367,13 @@ portless
 }
 async function main() {
   const args = process.argv.slice(2);
+  const isNpx = process.env.npm_command === "exec" && !process.env.npm_lifecycle_event;
+  const isPnpmDlx = !!process.env.PNPM_SCRIPT_SRC_DIR && !process.env.npm_lifecycle_event;
+  if (isNpx || isPnpmDlx) {
+    console.error(chalk.red("Error: portless should not be run via npx or pnpm dlx."));
+    console.log(chalk.blue("Install globally: npm install -g portless"));
+    process.exit(1);
+  }
   const skipPortless = process.env.PORTLESS === "0" || process.env.PORTLESS === "skip";
   if (skipPortless && args.length >= 2 && args[0] !== "proxy") {
     spawnCommand(args.slice(1));
@@ -338,6 +386,10 @@ ${chalk.bold("portless")} - Replace port numbers with stable, named .localhost U
 Eliminates port conflicts, memorizing port numbers, and cookie/storage
 clashes by giving each dev server a stable .localhost URL.
 
+${chalk.bold("Install:")}
+  ${chalk.cyan("npm install -g portless")}
+  Do NOT add portless as a project dependency.
+
 ${chalk.bold("Usage:")}
   ${chalk.cyan("sudo portless proxy")}              Start the proxy (run once, keep open)
   ${chalk.cyan("sudo portless proxy --port 8080")}  Start the proxy on a custom port
@@ -346,9 +398,9 @@ ${chalk.bold("Usage:")}
   ${chalk.cyan("portless list")}                    Show active routes
 
 ${chalk.bold("Examples:")}
-  sudo portless proxy              # Start proxy in terminal 1
-  portless myapp next dev          # Terminal 2 -> http://myapp.localhost
-  portless api.myapp pnpm start    # Terminal 3 -> http://api.myapp.localhost
+  sudo portless proxy               # Start proxy in terminal 1
+  portless myapp next dev           # Terminal 2 -> http://myapp.localhost
+  portless api.myapp pnpm start     # Terminal 3 -> http://api.myapp.localhost
 
 ${chalk.bold("In package.json:")}
   {
@@ -374,7 +426,7 @@ ${chalk.bold("Skip portless:")}
     process.exit(0);
   }
   if (args[0] === "--version" || args[0] === "-v") {
-    console.log("0.2.0");
+    console.log("0.2.2");
     process.exit(0);
   }
   if (args[0] === "list") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portless",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Replace port numbers with stable, named .localhost URLs. For humans and agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,6 +17,7 @@
   "files": [
     "dist"
   ],
+  "packageManager": "pnpm@9.15.4",
   "engines": {
     "node": ">=20"
   },
@@ -24,6 +25,21 @@
     "darwin",
     "linux"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "prepublishOnly": "pnpm build",
+    "pretest": "pnpm build",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepare": "husky"
+  },
   "keywords": [
     "local",
     "development",
@@ -65,18 +81,5 @@
       "prettier --write"
     ],
     "*.{json,md,yml,yaml}": "prettier --write"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "pretest": "pnpm build",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
   }
-}
+}