port-doctor-cli 1.0.0

package/dist/utils/exec.d.ts

@@ -0,0 +1,16 @@
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export declare function safeExec(command: string, options?: {
+    timeout?: number;
+    cwd?: string;
+    maxBuffer?: number;
+}): Promise<ExecResult>;
+export declare function safeExecFile(file: string, args: string[], options?: {
+    timeout?: number;
+    cwd?: string;
+    maxBuffer?: number;
+}): Promise<ExecResult>;
+//# sourceMappingURL=exec.d.ts.map

package/dist/utils/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnE,OAAO,CAAC,UAAU,CAAC,CAqBrB;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnE,OAAO,CAAC,UAAU,CAAC,CAqBrB"}

package/dist/utils/exec.js

@@ -0,0 +1,51 @@
+import { exec, execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execAsync = promisify(exec);
+const execFileAsync = promisify(execFile);
+export async function safeExec(command, options = {}) {
+    const { timeout = 5000, cwd, maxBuffer = 10 * 1024 * 1024 } = options;
+    try {
+        const { stdout, stderr } = await execAsync(command, {
+            timeout,
+            cwd,
+            maxBuffer,
+            windowsHide: true,
+        });
+        return {
+            stdout: stdout.trim(),
+            stderr: stderr.trim(),
+            exitCode: 0,
+        };
+    }
+    catch (err) {
+        return {
+            stdout: (err.stdout || '').toString().trim(),
+            stderr: (err.stderr || err.message || '').toString().trim(),
+            exitCode: typeof err.code === 'number' ? err.code : 1,
+        };
+    }
+}
+export async function safeExecFile(file, args, options = {}) {
+    const { timeout = 5000, cwd, maxBuffer = 10 * 1024 * 1024 } = options;
+    try {
+        const { stdout, stderr } = await execFileAsync(file, args, {
+            timeout,
+            cwd,
+            maxBuffer,
+            windowsHide: true,
+        });
+        return {
+            stdout: stdout.trim(),
+            stderr: stderr.trim(),
+            exitCode: 0,
+        };
+    }
+    catch (err) {
+        return {
+            stdout: (err.stdout || '').toString().trim(),
+            stderr: (err.stderr || err.message || '').toString().trim(),
+            exitCode: typeof err.code === 'number' ? err.code : 1,
+        };
+    }
+}
+//# sourceMappingURL=exec.js.map

package/dist/utils/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/utils/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAClC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAQ1C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAe,EACf,UAAkE,EAAE;IAEpE,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,EAAE,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACtE,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;YAClD,OAAO;YACP,GAAG;YACH,SAAS;YACT,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;YACrB,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;YACrB,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO;YACL,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;YAC5C,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;YAC3D,QAAQ,EAAE,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACtD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,IAAc,EACd,UAAkE,EAAE;IAEpE,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,EAAE,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACtE,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE;YACzD,OAAO;YACP,GAAG;YACH,SAAS;YACT,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;YACrB,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;YACrB,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO;YACL,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;YAC5C,MAAM,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;YAC3D,QAAQ,EAAE,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACtD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/utils/formatting.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Time, size, and text formatting helpers
+ */
+export declare function formatDuration(seconds: number): string;
+export declare function formatBytes(bytes: number): string;
+export declare function shortenPath(fullPath: string, maxLength?: number): string;
+export declare function stripAnsi(str: string): string;
+export declare function visibleWidth(str: string): number;
+export declare function pad(str: string, length: number, align?: 'left' | 'right'): string;
+//# sourceMappingURL=formatting.d.ts.map

package/dist/utils/formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting.d.ts","sourceRoot":"","sources":["../../src/utils/formatting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBtD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAapE;AAKD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,OAAgB,GAAG,MAAM,CAKzF"}

package/dist/utils/formatting.js

@@ -0,0 +1,60 @@
+/**
+ * Time, size, and text formatting helpers
+ */
+export function formatDuration(seconds) {
+    if (seconds < 0)
+        return 'unknown';
+    if (seconds < 60)
+        return `${Math.floor(seconds)}s`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60) {
+        const sec = Math.floor(seconds % 60);
+        return sec > 0 ? `${minutes}m ${sec}s` : `${minutes}m`;
+    }
+    const hours = Math.floor(minutes / 60);
+    const remainingMins = minutes % 60;
+    if (hours < 24) {
+        return remainingMins > 0 ? `${hours}h ${remainingMins}m` : `${hours}h`;
+    }
+    const days = Math.floor(hours / 24);
+    const remainingHours = hours % 24;
+    return remainingHours > 0 ? `${days}d ${remainingHours}h` : `${days}d`;
+}
+export function formatBytes(bytes) {
+    if (bytes <= 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    return `${(bytes / Math.pow(1024, i)).toFixed(1)} ${units[i]}`;
+}
+export function shortenPath(fullPath, maxLength = 35) {
+    if (!fullPath)
+        return '';
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    let p = fullPath;
+    if (home && p.startsWith(home)) {
+        p = '~' + p.slice(home.length);
+    }
+    if (p.length <= maxLength)
+        return p;
+    const parts = p.split('/');
+    if (parts.length <= 3)
+        return p;
+    return `${parts[0]}/${parts[1]}/.../${parts[parts.length - 1]}`;
+}
+// ANSI escape code regular expression
+const ANSI_REGEX = /\x1b\[[0-9;]*m/g;
+export function stripAnsi(str) {
+    return str.replace(ANSI_REGEX, '');
+}
+export function visibleWidth(str) {
+    return stripAnsi(str).length;
+}
+export function pad(str, length, align = 'left') {
+    const visible = visibleWidth(str);
+    if (visible >= length)
+        return str;
+    const padding = ' '.repeat(length - visible);
+    return align === 'left' ? str + padding : padding + str;
+}
+//# sourceMappingURL=formatting.js.map

package/dist/utils/formatting.js.map

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

package/dist/utils/redaction.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Sensitive token and credential redaction utilities
+ */
+export declare function redactSensitiveData(input: string): string;
+//# sourceMappingURL=redaction.d.ts.map

package/dist/utils/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../src/utils/redaction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAoBzD"}

package/dist/utils/redaction.js

@@ -0,0 +1,31 @@
+/**
+ * Sensitive token and credential redaction utilities
+ */
+const SENSITIVE_PATTERNS = [
+    /(?:password|passwd|secret|token|api[_-]?key|apikey|auth[_-]?token|access[_-]?token|bearer|private[_-]?key|client[_-]?secret)[=\s]+([^\s&"']+)/gi,
+    /(?:--password|--token|--secret|--key|--api-key|--auth-token|--client-secret)[=\s]+([^\s"']+)/gi,
+    /(?:mongodb(?:\+srv)?|postgres(?:ql)?|mysql|redis|amqp(?:s)?):\/\/(?:[^:@\s"']+):([^@\s"']+)@/gi,
+    /Bearer\s+([a-zA-Z0-9_\-\.]{15,})/gi,
+    /eyJ[a-zA-Z0-9_-]{10,}\.[a-zA-Z0-9_-]{10,}\.[a-zA-Z0-9_-]{10,}/g, // JWTs
+];
+export function redactSensitiveData(input) {
+    if (!input)
+        return input;
+    let redacted = input;
+    for (const pattern of SENSITIVE_PATTERNS) {
+        redacted = redacted.replace(pattern, (match, ...groups) => {
+            // Find the secret group if captured
+            if (groups.length > 0 && typeof groups[0] === 'string') {
+                const secret = groups[0];
+                if (secret.length <= 4) {
+                    return match.replace(secret, '***');
+                }
+                const masked = `${secret.slice(0, 2)}***${secret.slice(-2)}`;
+                return match.replace(secret, masked);
+            }
+            return '[REDACTED]';
+        });
+    }
+    return redacted;
+}
+//# sourceMappingURL=redaction.js.map

package/dist/utils/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../src/utils/redaction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,kBAAkB,GAAG;IACzB,iJAAiJ;IACjJ,gGAAgG;IAChG,gGAAgG;IAChG,oCAAoC;IACpC,gEAAgE,EAAE,OAAO;CAC1E,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACzC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,MAAM,EAAE,EAAE;YACxD,oCAAoC;YACpC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACvD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACzB,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;oBACvB,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACtC,CAAC;gBACD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YACD,OAAO,YAAY,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "port-doctor-cli",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Developer-first diagnostic, troubleshooting, and forensic CLI for local development ports",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "port-doctor": "./bin/port-doctor.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "port",
+    "port-doctor",
+    "port-doctor-cli",
+    "port-killer",
+    "diagnostics",
+    "developer-tools",
+    "eaddrinuse",
+    "troubleshooting",
+    "process",
+    "git",
+    "cli"
+  ],
+  "author": "Gaurav Singh Negi",
+  "license": "MIT",
+  "dependencies": {
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8"
+  }
+}