*

* This gives child processes a chance to clean up (close connections, remove

* temp files, terminate their own children) before being hard-killed.

*

* When the child was spawned with `detached: false` (e.g. service-managed

* runtime under launchd/systemd), pass `detached: false` to skip the Unix

* `process.kill(-pid, ...)` group-kill — it would otherwise target the

* gateway's own process group and SIGTERM the gateway itself. (#71662)

*/

export function killProcessTree(pid: number, opts?: { graceMs?: number }): void {

export function killProcessTree(

pid: number,

opts?: { graceMs?: number; detached?: boolean },

): void {

if (!Number.isFinite(pid) || pid <= 0) {

return;

}

return;

}

killProcessTreeUnix(pid, graceMs);

killProcessTreeUnix(pid, graceMs, opts?.detached !== false);

}

function normalizeGraceMs(value?: number): number {

}

}

function killProcessTreeUnix(pid: number, graceMs: number): void {

// Step 1: Try graceful SIGTERM to process group

try {

process.kill(-pid, "SIGTERM");

} catch {

// Process group doesn't exist or we lack permission - try direct

function killProcessTreeUnix(pid: number, graceMs: number, useGroupKill: boolean): void {

// Step 1: Try graceful SIGTERM. Prefer process-group kill (`-pid`) when the

// child was spawned detached so it has its own group; otherwise stick to the

// direct pid to avoid SIGTERMing our own process group (the gateway). (#71662)

if (useGroupKill) {

try {

process.kill(-pid, "SIGTERM");

} catch {

// Process group doesn't exist or we lack permission - try direct

try {

process.kill(pid, "SIGTERM");

} catch {

// Already gone

return;

}

}

} else {

try {

process.kill(pid, "SIGTERM");

} catch {

// Step 2: Wait grace period, then SIGKILL if still alive

setTimeout(() => {

if (isProcessAlive(-pid)) {

if (useGroupKill && isProcessAlive(-pid)) {

try {

process.kill(-pid, "SIGKILL");

return;