@vibe-validate/utils 0.18.1 → 0.18.2-rc.1

package/dist/index.d.ts

@@ -8,4 +8,5 @@
  */
 export { safeExecSync, safeExecFromString, safeExecResult, isToolAvailable, getToolVersion, hasShellSyntax, CommandExecutionError, type SafeExecOptions, type SafeExecResult } from './safe-exec.js';
 export { normalizedTmpdir, mkdirSyncReal, normalizePath } from './path-helpers.js';
+export { isProcessRunning } from './process-check.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACd,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACd,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,gBAAgB,EACjB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -10,4 +10,6 @@
 export { safeExecSync, safeExecFromString, safeExecResult, isToolAvailable, getToolVersion, hasShellSyntax, CommandExecutionError } from './safe-exec.js';
 // Cross-platform path helpers (Windows 8.3 short name handling)
 export { normalizedTmpdir, mkdirSyncReal, normalizePath } from './path-helpers.js';
+// Process checking (cross-platform)
+export { isProcessRunning } from './process-check.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6CAA6C;AAC7C,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,qBAAqB,EAGtB,MAAM,gBAAgB,CAAC;AAExB,gEAAgE;AAChE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACd,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6CAA6C;AAC7C,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,EACd,qBAAqB,EAGtB,MAAM,gBAAgB,CAAC;AAExB,gEAAgE;AAChE,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,aAAa,EACd,MAAM,mBAAmB,CAAC;AAE3B,oCAAoC;AACpC,OAAO,EACL,gBAAgB,EACjB,MAAM,oBAAoB,CAAC"}

package/dist/process-check.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Check if a process is currently running
+ *
+ * Cross-platform implementation:
+ * - Windows: Uses `tasklist /FI "PID eq ${pid}" /NH` command
+ * - Unix/Mac: Uses `process.kill(pid, 0)` (signal 0 = check existence only)
+ *
+ * Security: Uses safeExecSync for Windows (no shell injection risk)
+ *
+ * @param pid - Process ID to check
+ * @returns true if process is running, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // Check if process exists
+ * if (isProcessRunning(12345)) {
+ *   console.log('Process 12345 is running');
+ * }
+ *
+ * // Check current process (always returns true)
+ * if (isProcessRunning(process.pid)) {
+ *   console.log('Current process is running');
+ * }
+ * ```
+ */
+export declare function isProcessRunning(pid: number): boolean;
+//# sourceMappingURL=process-check.d.ts.map

package/dist/process-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-check.d.ts","sourceRoot":"","sources":["../src/process-check.ts"],"names":[],"mappings":"AA4EA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAIrD"}

package/dist/process-check.js

@@ -0,0 +1,102 @@
+import { safeExecSync } from './safe-exec.js';
+/**
+ * Check if PID matches in Windows tasklist output
+ *
+ * Parses tasklist output line and extracts PID from second column.
+ * Avoids false positives from partial string matching.
+ *
+ * @param line - Single line from tasklist output
+ * @param pid - Target PID to match
+ * @returns true if line contains matching PID in correct column
+ */
+function matchesPidInTasklist(line, pid) {
+    // Skip empty lines and error messages
+    if (!line.trim() || line.includes('INFO:')) {
+        return false;
+    }
+    // Split by whitespace and extract second column (PID)
+    const columns = line.trim().split(/\s+/);
+    if (columns.length >= 2) {
+        const linePid = Number.parseInt(columns[1], 10);
+        return linePid === pid;
+    }
+    return false;
+}
+/**
+ * Check if a process is currently running (Windows implementation)
+ *
+ * Uses tasklist command to check process existence.
+ * Parses output correctly to avoid false positives from partial PID matches.
+ *
+ * @param pid - Process ID to check
+ * @returns true if process is running, false otherwise
+ */
+function isProcessRunningWindows(pid) {
+    try {
+        const result = safeExecSync('tasklist', ['/FI', `PID eq ${pid}`, '/NH'], {
+            encoding: 'utf8',
+        });
+        // Parse tasklist output format (columns separated by whitespace):
+        // Image Name                     PID Session Name        Session#    Mem Usage
+        // node.exe                    12345 Console                    1     45,678 K
+        const lines = result.split('\n');
+        return lines.some((line) => matchesPidInTasklist(line, pid));
+    }
+    catch {
+        // Command failed (process not found or tasklist unavailable)
+        return false;
+    }
+}
+/**
+ * Check if a process is currently running (Unix/Mac implementation)
+ *
+ * Uses process.kill(pid, 0) which checks process existence without sending a signal.
+ *
+ * @param pid - Process ID to check
+ * @returns true if process is running, false otherwise
+ */
+function isProcessRunningUnix(pid) {
+    try {
+        process.kill(pid, 0);
+        return true; // Process exists (no error thrown)
+    }
+    catch (err) {
+        // EPERM = process exists but no permission (still running)
+        // EACCES = permission denied (similar to EPERM on some platforms)
+        // ESRCH = process does not exist
+        // Other errors = treat as not running
+        const error = err;
+        return error.code === 'EPERM' || error.code === 'EACCES';
+    }
+}
+/**
+ * Check if a process is currently running
+ *
+ * Cross-platform implementation:
+ * - Windows: Uses `tasklist /FI "PID eq ${pid}" /NH` command
+ * - Unix/Mac: Uses `process.kill(pid, 0)` (signal 0 = check existence only)
+ *
+ * Security: Uses safeExecSync for Windows (no shell injection risk)
+ *
+ * @param pid - Process ID to check
+ * @returns true if process is running, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // Check if process exists
+ * if (isProcessRunning(12345)) {
+ *   console.log('Process 12345 is running');
+ * }
+ *
+ * // Check current process (always returns true)
+ * if (isProcessRunning(process.pid)) {
+ *   console.log('Current process is running');
+ * }
+ * ```
+ */
+export function isProcessRunning(pid) {
+    return process.platform === 'win32'
+        ? isProcessRunningWindows(pid)
+        : isProcessRunningUnix(pid);
+}
+//# sourceMappingURL=process-check.js.map

package/dist/process-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-check.js","sourceRoot":"","sources":["../src/process-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;GASG;AACH,SAAS,oBAAoB,CAAC,IAAY,EAAE,GAAW;IACrD,sCAAsC;IACtC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sDAAsD;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChD,OAAO,OAAO,KAAK,GAAG,CAAC;IACzB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,uBAAuB,CAAC,GAAW;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,EAAE,EAAE,KAAK,CAAC,EAAE;YACvE,QAAQ,EAAE,MAAM;SACjB,CAAW,CAAC;QAEb,kEAAkE;QAClE,+EAA+E;QAC/E,8EAA8E;QAC9E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;QAC7D,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,oBAAoB,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC,CAAC,mCAAmC;IAClD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,2DAA2D;QAC3D,kEAAkE;QAClE,iCAAiC;QACjC,sCAAsC;QACtC,MAAM,KAAK,GAAG,GAA4B,CAAC;QAC3C,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO;QACjC,CAAC,CAAC,uBAAuB,CAAC,GAAG,CAAC;QAC9B,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibe-validate/utils",
-  "version": "0.18.1",
+  "version": "0.18.2-rc.1",
   "description": "Common utilities for vibe-validate packages (command execution, path normalization)",
   "type": "module",
   "main": "./dist/index.js",