node-loop-detective 1.2.0 → 1.3.0

package/README.md

@@ -74,6 +74,9 @@ loop-detective -p 12345 -d 30 -t 100
 # Detect slow I/O with a 1-second threshold
 loop-detective -p 12345 --io-threshold 1000
 
+# Connect to a remote inspector (Docker, K8s, remote server)
+loop-detective --host 192.168.1.100 --port 9229
+
 # Continuous monitoring mode
 loop-detective -p 12345 --watch
 
@@ -86,6 +89,7 @@ loop-detective -p 12345 --json
 | Flag | Description | Default |
 |------|-------------|---------|
 | `-p, --pid <pid>` | Target Node.js process ID | — |
+| `-H, --host <host>` | Inspector host (remote connections) | 127.0.0.1 |
 | `-P, --port <port>` | Inspector port (skip SIGUSR1) | — |
 | `-d, --duration <sec>` | Profiling duration in seconds | 10 |
 | `-t, --threshold <ms>` | Event loop lag threshold | 50 |
@@ -124,6 +128,7 @@ const { Detective } = require('node-loop-detective');
 
 const detective = new Detective({
   pid: 12345,
+  inspectorHost: '127.0.0.1',  // or remote host
   duration: 10000,
   threshold: 50,
   interval: 100,

package/bin/cli.js

@@ -10,6 +10,7 @@ function parseCliArgs(argv) {
   const args = argv.slice(2);
   const values = {
     pid: null,
+    host: null,
     port: null,
     duration: '10',
     threshold: '50',
@@ -24,6 +25,7 @@ function parseCliArgs(argv) {
 
   const flagMap = {
     '-p': 'pid', '--pid': 'pid',
+    '-H': 'host', '--host': 'host',
     '-P': 'port', '--port': 'port',
     '-d': 'duration', '--duration': 'duration',
     '-t': 'threshold', '--threshold': 'threshold',
@@ -85,9 +87,11 @@ function printUsage() {
     loop-detective <pid>
     loop-detective --pid <pid>
     loop-detective --port <inspector-port>
+    loop-detective --host <remote-host> --port <inspector-port>
 
   OPTIONS
     -p, --pid <pid>          Target Node.js process ID
+    -H, --host <host>        Inspector host (default: 127.0.0.1)
     -P, --port <port>        Connect to an already-open inspector port
     -d, --duration <sec>     Profiling duration in seconds (default: 10)
     -t, --threshold <ms>     Event loop lag threshold in ms (default: 50)
@@ -102,6 +106,7 @@ function printUsage() {
     loop-detective 12345
     loop-detective --pid 12345 --duration 30 --threshold 100
     loop-detective --port 9229 --watch
+    loop-detective --host 192.168.1.100 --port 9229
     loop-detective -p 12345 -d 5 -j
 
   HOW IT WORKS
@@ -116,6 +121,7 @@ function printUsage() {
 async function main() {
   const config = {
     pid: pid ? parseInt(pid, 10) : null,
+    inspectorHost: values.host || '127.0.0.1',
     inspectorPort,
     duration: parseInt(values.duration, 10) * 1000,
     threshold: parseInt(values.threshold, 10),
@@ -128,6 +134,11 @@ async function main() {
   const reporter = new Reporter(config);
   const detective = new Detective(config);
 
+  // Security warning for remote connections
+  if (config.inspectorHost !== '127.0.0.1' && config.inspectorHost !== 'localhost') {
+    reporter.onInfo(`⚠ Warning: Connecting to remote host ${config.inspectorHost}. The CDP protocol has no authentication — ensure the network is trusted.`);
+  }
+
   detective.on('connected', () => reporter.onConnected());
   detective.on('lag', (data) => reporter.onLag(data));
   detective.on('slowIO', (data) => reporter.onSlowIO(data));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-loop-detective",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Detect event loop blocking & lag in running Node.js apps without code changes or restarts",
   "main": "src/index.js",
   "bin": {

package/src/detective.js

@@ -406,7 +406,7 @@ class Detective extends EventEmitter {
     this._activateInspector();
     const port = await this._findInspectorPort();
 
-    this.inspector = new Inspector({ port });
+    this.inspector = new Inspector({ host: this.config.inspectorHost, port });
     await this.inspector.connect();
     this.emit('connected');