feat: add watchdog pid as cleanup metadata arg

PR-URL: tapjs#59
Credit: @frattaro
Close: tapjs#59
Reviewed-by: @isaacs

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changes
 
+## v3.3
+
+- Include `watchdogPid` as a metadata argument to cleanup
+  function
+
 ## v3.2
 
 - Export `watchdog` and `proxySignals` functionality

src/index.ts

@@ -4,6 +4,7 @@ import {
   Serializable,
   spawn as nodeSpawn,
   SpawnOptions,
+  ChildProcess,
 } from 'child_process'
 import crossSpawn from 'cross-spawn'
 import { onExit } from 'signal-exit'
@@ -37,6 +38,9 @@ const spawn = process?.platform === 'win32' ? crossSpawn : nodeSpawn
 export type Cleanup = (
   code: number | null,
   signal: null | NodeJS.Signals,
+  processInfo: {
+    watchdogPid: ChildProcess['pid']
+  },
 ) =>
   | void
   | undefined
@@ -159,15 +163,17 @@ export function foregroundChild(
   const removeOnExit = onExit(childHangup)
 
   proxySignals(child)
-  watchdog(child)
+  const dog = watchdog(child)
 
   let done = false
   child.on('close', async (code, signal) => {
     /* c8 ignore start */
     if (done) return
     /* c8 ignore stop */
     done = true
-    const result = cleanup(code, signal)
+    const result = cleanup(code, signal, {
+      watchdogPid: dog.pid,
+    })
     const res = isPromise(result) ? await result : result
     removeOnExit()