port-nuker 1.0.3 → 1.0.4

package/README.md

@@ -32,6 +32,9 @@ nuke <PORT>
 # Kill and wait until port is actually free
 nuke <PORT> --wait
 
+# Force kill even on protected ports
+nuke <PORT> --force
+
 # List all active ports and select one to kill interactively
 nuke list
 ```
@@ -87,6 +90,7 @@ nuke 5000 --wait && echo "Port is free!"
 ## Features
 
 - **Cross-Platform**: Works on Windows (using `netstat` + `taskkill`) and Unix-like systems (Linux/macOS using `lsof` + `kill`)
+- **Safe Mode Protection**: Protected ports (22, 80, 443, 3306, 5432, 6379, 27017, 5000, 8080) require `--force` flag to prevent accidental termination of critical services
 - **Interactive Mode**: Browse all active ports with `nuke list` and select which one to kill
 - **Wait Mode**: Block until port is actually released with `--wait` flag for safe command chaining
 - **Detailed Process Info**: See PID, command name, user, memory usage, and protocol for each port
@@ -113,6 +117,25 @@ nuke 8080
 node server.js
 ```
 
+### Protected Ports (Safe Mode)
+
+```bash
+# Attempting to kill a protected port (e.g., SSH on 22)
+nuke 22
+# Output:
+# ⚠️  Port 22 is protected (SSH).
+#    This port is typically used for critical services.
+#    Use --force to override: nuke 22 --force
+
+# Force kill a protected port
+nuke 443 --force
+# Successfully nukes the process on port 443 (HTTPS)
+
+# Protected ports: 22 (SSH), 80 (HTTP), 443 (HTTPS), 3306 (MySQL),
+#                  5432 (PostgreSQL), 6379 (Redis), 27017 (MongoDB),
+#                  5000 (Flask/Docker), 8080 (Alt HTTP)
+```
+
 ## Requirements
 
 - Node.js >= 12.0.0

package/index.js

@@ -5,16 +5,34 @@ const os = require('os');
 const inquirer = require('inquirer');
 const Table = require('cli-table3');
 
+// Protected ports that require --force flag
+const SAFE_PORTS = [22, 80, 443, 3306, 5432, 6379, 27017, 5000, 8080];
+
+const SAFE_PORT_DESCRIPTIONS = {
+  22: 'SSH',
+  80: 'HTTP',
+  443: 'HTTPS',
+  3306: 'MySQL',
+  5432: 'PostgreSQL',
+  6379: 'Redis',
+  27017: 'MongoDB',
+  5000: 'Flask/Docker Registry',
+  8080: 'Alternative HTTP'
+};
+
 const args = process.argv.slice(2);
 
 // Parse arguments
 let port = null;
 let shouldWait = false;
+let shouldForce = false;
 let command = null;
 
 for (let i = 0; i < args.length; i++) {
   if (args[i] === '--wait') {
     shouldWait = true;
+  } else if (args[i] === '--force') {
+    shouldForce = true;
   } else if (args[i] === 'list') {
     command = 'list';
   } else if (!isNaN(args[i])) {
@@ -26,16 +44,34 @@ for (let i = 0; i < args.length; i++) {
 if (command === 'list') {
   listPorts();
 } else if (port) {
-  // nuke <PORT> [--wait]
-  nukePort(port, shouldWait);
+  // nuke <PORT> [--wait] [--force]
+  nukePort(port, shouldWait, shouldForce);
 } else {
   console.error('Usage:');
-  console.error('  nuke <PORT>           Kill process on specific port');
-  console.error('  nuke <PORT> --wait    Kill process and wait until port is free');
-  console.error('  nuke list             List all active ports and select one to kill');
+  console.error('  nuke <PORT>              Kill process on specific port');
+  console.error('  nuke <PORT> --wait       Kill process and wait until port is free');
+  console.error('  nuke <PORT> --force      Force kill even on protected ports');
+  console.error('  nuke list                List all active ports and select one to kill');
+  console.error('');
+  console.error('Protected ports (require --force): 22, 80, 443, 3306, 5432, 6379, 27017, 5000, 8080');
   process.exit(1);
 }
 
+// Check if a port is protected and requires --force flag
+function checkSafePort(port, force) {
+  const portNum = parseInt(port);
+  
+  if (SAFE_PORTS.includes(portNum) && !force) {
+    const description = SAFE_PORT_DESCRIPTIONS[portNum] || 'System Service';
+    console.error(`\n⚠️  Port ${port} is protected (${description}).`);
+    console.error(`   This port is typically used for critical services.`);
+    console.error(`   Use --force to override: nuke ${port} --force\n`);
+    return false;
+  }
+  
+  return true;
+}
+
 // List all active ports with process details
 function listPorts() {
   const platform = os.platform();
@@ -235,11 +271,22 @@ async function promptKillProcess(processes) {
     if (answer.pid) {
       const selectedProcess = processes.find(p => p.pid === answer.pid);
       
+      // Check if port is protected
+      const portNum = parseInt(selectedProcess.port);
+      const isProtected = SAFE_PORTS.includes(portNum);
+      
+      let confirmMessage = `Kill process ${selectedProcess.command} (PID: ${answer.pid}) on port ${selectedProcess.port}?`;
+      
+      if (isProtected) {
+        const description = SAFE_PORT_DESCRIPTIONS[portNum] || 'System Service';
+        confirmMessage = `⚠️  Port ${selectedProcess.port} is protected (${description}).\n   Kill process ${selectedProcess.command} (PID: ${answer.pid})?`;
+      }
+      
       const confirm = await inquirer.prompt([
         {
           type: 'confirm',
           name: 'confirmed',
-          message: `Kill process ${selectedProcess.command} (PID: ${answer.pid}) on port ${selectedProcess.port}?`,
+          message: confirmMessage,
           default: false
         }
       ]);
@@ -335,7 +382,12 @@ function pollPortUntilFree(port, maxWaitSeconds = 30) {
 }
 
 // Original nuke port function
-function nukePort(port, shouldWait = false) {
+function nukePort(port, shouldWait = false, shouldForce = false) {
+  // Check if port is protected
+  if (!checkSafePort(port, shouldForce)) {
+    process.exit(1);
+  }
+  
   const platform = os.platform();
   let findCommand;
   

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "port-nuker",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "A simple CLI utility to kill processes holding a specific port. Solves EADDRINUSE errors instantly.",
   "main": "index.js",
   "bin": {