@qzda/port 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# @qzda/port
+
+Cross-platform CLI tool to list listening TCP ports and the programs occupying them.
+
+## Install
+
+```bash
+npm install -g @qzda/port
+```
+
+## Usage
+
+```bash
+port list
+```
+
+Example output:
+
+```
+PID    PORT  PROGRAM
+-----  ----  -------
+1234   22    sshd
+5678   80    nginx
+12345  3000  node
+```
+
+## Supported Platforms
+
+| Platform | Method |
+|----------|--------|
+| Linux | `ss -tlnp` (fallback `netstat -tlnp`) |
+| macOS | `lsof -iTCP -sTCP:LISTEN -P -n` |
+| Windows | `netstat -ano` + `tasklist` |
+
+## Development
+
+```bash
+git clone git@github.com:qzda/port.git
+cd port
+npm install
+npm run build
+node dist/index.js list
+```
+
+## License
+
+MIT

package/dist/format.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTable = formatTable;
+function formatTable(entries) {
+    if (entries.length === 0) {
+        return 'No listening ports found.';
+    }
+    const pidHeader = 'PID';
+    const portHeader = 'PORT';
+    const programHeader = 'PROGRAM';
+    const pidWidth = Math.max(pidHeader.length, ...entries.map((e) => String(e.pid).length));
+    const portWidth = Math.max(portHeader.length, ...entries.map((e) => String(e.port).length));
+    const programWidth = Math.max(programHeader.length, ...entries.map((e) => e.program.length));
+    const header = `${pidHeader.padEnd(pidWidth)}  ${portHeader.padEnd(portWidth)}  ${programHeader}`;
+    const separator = `${'-'.repeat(pidWidth)}  ${'-'.repeat(portWidth)}  ${'-'.repeat(programWidth)}`;
+    const rows = entries.map((e) => `${String(e.pid).padEnd(pidWidth)}  ${String(e.port).padEnd(portWidth)}  ${e.program}`);
+    return [header, separator, ...rows].join('\n');
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":";;AAEA,kCA+BC;AA/BD,SAAgB,WAAW,CAAC,OAAoB;IAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,MAAM,SAAS,GAAG,KAAK,CAAC;IACxB,MAAM,UAAU,GAAG,MAAM,CAAC;IAC1B,MAAM,aAAa,GAAG,SAAS,CAAC;IAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CACvB,SAAS,CAAC,MAAM,EAChB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAC5C,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,UAAU,CAAC,MAAM,EACjB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAC7C,CAAC;IACF,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,aAAa,CAAC,MAAM,EACpB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CACxC,CAAC;IAEF,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,aAAa,EAAE,CAAC;IAClG,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;IAEnG,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CACtB,CAAC,CAAC,EAAE,EAAE,CACJ,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CACzF,CAAC;IAEF,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const scanner_js_1 = require("./scanner.js");
+const format_js_1 = require("./format.js");
+const program = new commander_1.Command();
+program
+    .name('port')
+    .description('List listening TCP ports on the current machine')
+    .version('0.1.0');
+program
+    .command('list')
+    .description('List all listening TCP ports with PID, port number, and program name')
+    .action(async () => {
+    try {
+        const entries = await (0, scanner_js_1.scanPorts)();
+        console.log((0, format_js_1.formatTable)(entries));
+    }
+    catch (err) {
+        console.error('Error:', err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+});
+// Show help if no command is given
+program.parse();
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,6CAAyC;AACzC,2CAA0C;AAE1C,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,MAAM,CAAC;KACZ,WAAW,CAAC,iDAAiD,CAAC;KAC9D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,sEAAsE,CAAC;KACnF,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAA,sBAAS,GAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,IAAA,uBAAW,EAAC,OAAO,CAAC,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,mCAAmC;AACnC,OAAO,CAAC,KAAK,EAAE,CAAC;AAEhB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,OAAO,CAAC,UAAU,EAAE,CAAC;AACvB,CAAC"}

package/dist/parsers/darwin.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scan = scan;
+const child_process_1 = require("child_process");
+function execCommand(command, args) {
+    return new Promise((resolve, reject) => {
+        (0, child_process_1.execFile)(command, args, { timeout: 15000 }, (err, stdout) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve(stdout);
+            }
+        });
+    });
+}
+/**
+ * Parse `lsof -iTCP -sTCP:LISTEN -P -n` output.
+ * Example lines:
+ *   COMMAND   PID   USER   FD   TYPE     DEVICE SIZE/OFF NODE NAME
+ *   node    12345  user   23u  IPv4 0x1234abcd      0t0  TCP *:3000 (LISTEN)
+ *   sshd      678  root    5u  IPv6 0xabcd1234      0t0  TCP *:22 (LISTEN)
+ *   nginx    9012  root    6u  IPv4 0xdefg5678      0t0  TCP 127.0.0.1:8080 (LISTEN)
+ *   java     5555  user  123u  IPv6 0xaaaa1111      0t0  TCP [::1]:9090 (LISTEN)
+ */
+function parseLsof(output) {
+    const entries = [];
+    const seen = new Set();
+    // Regex captures: COMMAND, PID, and the NAME field (address:port before (LISTEN))
+    const re = /^(\S+)\s+(\d+)\s+.*TCP\s+(\S+)\s+\(LISTEN\)/gm;
+    let match;
+    while ((match = re.exec(output)) !== null) {
+        const program = match[1];
+        const pid = parseInt(match[2], 10);
+        const nameField = match[3];
+        // Extract port from NAME field: *:3000, 127.0.0.1:8080, [::1]:9090
+        const portMatch = nameField.match(/:(\d+)$/);
+        if (!portMatch)
+            continue;
+        const port = parseInt(portMatch[1], 10);
+        const key = `${pid}:${port}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            entries.push({ pid, port, program });
+        }
+    }
+    return entries;
+}
+async function scan() {
+    try {
+        const stdout = await execCommand('lsof', ['-iTCP', '-sTCP:LISTEN', '-P', '-n']);
+        return parseLsof(stdout);
+    }
+    catch (err) {
+        if (err?.code === 'ENOENT') {
+            throw new Error('`lsof` is not installed. Install it to use this tool:\n' +
+                '  macOS: it should be available by default. If missing, install Xcode CLI tools.\n' +
+                '  Linux: apt install lsof / yum install lsof');
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=darwin.js.map

package/dist/parsers/darwin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"darwin.js","sourceRoot":"","sources":["../../src/parsers/darwin.ts"],"names":[],"mappings":";;AAoDA,oBAcC;AAlED,iDAAyC;AAGzC,SAAS,WAAW,CAAC,OAAe,EAAE,IAAc;IAClD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAA,wBAAQ,EAAC,OAAO,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,GAAiB,EAAE,MAAc,EAAE,EAAE;YAChF,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,SAAS,CAAC,MAAc;IAC/B,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,kFAAkF;IAClF,MAAM,EAAE,GAAG,+CAA+C,CAAC;IAE3D,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAE3B,mEAAmE;QACnE,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS;YAAE,SAAS;QAEzB,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAEM,KAAK,UAAU,IAAI;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QAChF,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,IAAI,GAAG,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,yDAAyD;gBACzD,oFAAoF;gBACpF,8CAA8C,CAC/C,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/parsers/linux.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scan = scan;
+const child_process_1 = require("child_process");
+function execCommand(command, args) {
+    return new Promise((resolve, reject) => {
+        (0, child_process_1.execFile)(command, args, { timeout: 15000 }, (err, stdout) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve(stdout);
+            }
+        });
+    });
+}
+/**
+ * Parse `ss -tlnp` output.
+ * Example lines:
+ *   LISTEN 0 128 0.0.0.0:22 0.0.0.0:* users:(("sshd",pid=1234,fd=3))
+ *   LISTEN 0 128 [::]:80 [::]:* users:(("nginx",pid=5678,fd=6))
+ */
+function parseSs(output) {
+    const entries = [];
+    const seen = new Set();
+    // Matches: address:port  address:* users:(("name",pid=NNN,...
+    const re = /\S+:(\d+)\s+\S+:\*\s+users:\(\(\"(\S+)\",pid=(\d+)/g;
+    for (const line of output.split('\n')) {
+        let match;
+        while ((match = re.exec(line)) !== null) {
+            const port = parseInt(match[1], 10);
+            const program = match[2];
+            const pid = parseInt(match[3], 10);
+            const key = `${pid}:${port}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                entries.push({ pid, port, program });
+            }
+        }
+    }
+    return entries;
+}
+/**
+ * Parse `netstat -tlnp` output (fallback).
+ * Example lines:
+ *   tcp  0  0  0.0.0.0:22  0.0.0.0:*  LISTEN  1234/sshd
+ *   tcp6 0  0  :::80        :::*       LISTEN  5678/nginx
+ */
+function parseNetstat(output) {
+    const entries = [];
+    const seen = new Set();
+    const re = /^\S+\s+\d+\s+\d+\s+\S+:(\d+)\s+\S+\s+LISTEN\s+(\d+)\/(\S+)/gm;
+    let match;
+    while ((match = re.exec(output)) !== null) {
+        const port = parseInt(match[1], 10);
+        const pid = parseInt(match[2], 10);
+        const program = match[3];
+        const key = `${pid}:${port}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            entries.push({ pid, port, program });
+        }
+    }
+    return entries;
+}
+async function scan() {
+    // Try `ss -tlnp` first
+    try {
+        const stdout = await execCommand('ss', ['-tlnp']);
+        return parseSs(stdout);
+    }
+    catch {
+        // ss failed, try netstat as fallback
+    }
+    try {
+        const stdout = await execCommand('netstat', ['-tlnp']);
+        return parseNetstat(stdout);
+    }
+    catch {
+        // netstat also failed
+    }
+    throw new Error('Neither `ss` nor `netstat` is available. ' +
+        'Install iproute2 (`ss`) or net-tools (`netstat`) to use this tool.');
+}
+//# sourceMappingURL=linux.js.map

package/dist/parsers/linux.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linux.js","sourceRoot":"","sources":["../../src/parsers/linux.ts"],"names":[],"mappings":"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"}

package/dist/parsers/win32.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scan = scan;
+const child_process_1 = require("child_process");
+function execCommand(command, args) {
+    return new Promise((resolve, reject) => {
+        (0, child_process_1.execFile)(command, args, { timeout: 15000 }, (err, stdout) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve(stdout);
+            }
+        });
+    });
+}
+/**
+ * Parse `netstat -ano` output for LISTENING TCP ports.
+ * Example lines:
+ *   TCP    0.0.0.0:3000          0.0.0.0:0              LISTENING       12345
+ *   TCP    127.0.0.1:8080        0.0.0.0:0              LISTENING       5678
+ *   TCP    [::]:80               [::]:0                  LISTENING       4
+ */
+function parseNetstat(output) {
+    // pid -> ports[]
+    const pidPorts = new Map();
+    const re = /^\s*(?:TCP|TCPv6)\s+\[?([^\]]+)\]?:(\d+)\s+.*LISTENING\s+(\d+)/gm;
+    let match;
+    while ((match = re.exec(output)) !== null) {
+        const port = parseInt(match[2], 10);
+        const pid = parseInt(match[3], 10);
+        const ports = pidPorts.get(pid);
+        if (ports) {
+            if (!ports.includes(port)) {
+                ports.push(port);
+            }
+        }
+        else {
+            pidPorts.set(pid, [port]);
+        }
+    }
+    return pidPorts;
+}
+/**
+ * Resolve a single PID to a process name using `tasklist`.
+ * Example output: `"node.exe","12345","Console","1","123,456 K"`
+ */
+async function resolveProcessName(pid) {
+    // Special PIDs on Windows
+    if (pid === 0)
+        return 'System Idle Process';
+    if (pid === 4)
+        return 'System';
+    try {
+        const stdout = await execCommand('tasklist', [
+            '/FI', `PID eq ${pid}`,
+            '/FO', 'CSV',
+            '/NH',
+        ]);
+        // Parse CSV: "program.exe","pid","session","session#","mem usage"
+        const match = stdout.match(/^"([^"]+)"/m);
+        if (match) {
+            return match[1];
+        }
+    }
+    catch {
+        // tasklist failed for this PID
+    }
+    return '<unknown>';
+}
+async function scan() {
+    // Phase 1: netstat -ano to get listening ports and PIDs
+    const netstatOutput = await execCommand('netstat', ['-ano']);
+    const pidPorts = parseNetstat(netstatOutput);
+    if (pidPorts.size === 0)
+        return [];
+    // Phase 2: resolve each PID to a process name
+    const entries = [];
+    for (const [pid, ports] of pidPorts) {
+        const program = await resolveProcessName(pid);
+        for (const port of ports) {
+            entries.push({ pid, port, program });
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=win32.js.map

package/dist/parsers/win32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"win32.js","sourceRoot":"","sources":["../../src/parsers/win32.ts"],"names":[],"mappings":"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"}

package/dist/scanner.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanPorts = scanPorts;
+async function scanPorts() {
+    switch (process.platform) {
+        case 'linux':
+            return (await import('./parsers/linux.js')).scan();
+        case 'darwin':
+            return (await import('./parsers/darwin.js')).scan();
+        case 'win32':
+            return (await import('./parsers/win32.js')).scan();
+        default:
+            throw new Error(`Unsupported platform: ${process.platform}`);
+    }
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":";;AAEA,8BAWC;AAXM,KAAK,UAAU,SAAS;IAC7B,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,CAAC,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrD,KAAK,QAAQ;YACX,OAAO,CAAC,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,KAAK,OAAO;YACV,OAAO,CAAC,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrD;YACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@qzda/port",
+  "version": "0.1.0",
+  "description": "Cross-platform CLI tool to list listening TCP ports",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qzda/port.git"
+  },
+  "bin": {
+    "port": "./dist/index.js"
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "commander": "^14.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}