@react-native-harness/tools 1.0.0 → 1.1.0-rc.2

package/dist/__tests__/abort.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=abort.test.d.ts.map

package/dist/__tests__/abort.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/abort.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/abort.test.js

@@ -0,0 +1,49 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { getTimeoutSignal, raceAbortSignals, withAbortTimeout } from '../abort.js';
+const createAbortError = () => new DOMException('The operation was aborted', 'AbortError');
+const waitForAbort = (signal) => {
+    if (signal.aborted) {
+        return Promise.resolve(signal.reason);
+    }
+    return new Promise((resolve) => {
+        signal.addEventListener('abort', () => {
+            resolve(signal.reason);
+        }, { once: true });
+    });
+};
+afterEach(() => {
+    vi.useRealTimers();
+});
+describe('abort helpers', () => {
+    it('aborts timeout signals after the configured duration', async () => {
+        vi.useFakeTimers();
+        const signal = getTimeoutSignal(1_000);
+        const abortPromise = waitForAbort(signal);
+        await vi.advanceTimersByTimeAsync(1_000);
+        await expect(abortPromise).resolves.toBeInstanceOf(DOMException);
+        expect(signal.aborted).toBe(true);
+        expect(signal.reason).toBeInstanceOf(DOMException);
+    });
+    it('races abort signals and preserves the first abort reason', async () => {
+        const first = new AbortController();
+        const second = new AbortController();
+        const signal = raceAbortSignals([first.signal, second.signal]);
+        const abortPromise = waitForAbort(signal);
+        const secondReason = new Error('second');
+        second.abort(secondReason);
+        first.abort(new Error('first'));
+        await expect(abortPromise).resolves.toBe(secondReason);
+    });
+    it('combines parent cancellation and timeout behavior', async () => {
+        vi.useFakeTimers();
+        const controller = new AbortController();
+        const signal = withAbortTimeout(controller.signal, 1_000);
+        const abortPromise = waitForAbort(signal);
+        controller.abort(createAbortError());
+        await expect(abortPromise).resolves.toBeInstanceOf(DOMException);
+        const timedSignal = withAbortTimeout(new AbortController().signal, 1_000);
+        const timedAbortPromise = waitForAbort(timedSignal);
+        await vi.advanceTimersByTimeAsync(1_000);
+        await expect(timedAbortPromise).resolves.toBeInstanceOf(DOMException);
+    });
+});

package/dist/__tests__/crash-artifacts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=crash-artifacts.test.d.ts.map

package/dist/__tests__/crash-artifacts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crash-artifacts.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/crash-artifacts.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/crash-artifacts.test.js

@@ -0,0 +1,77 @@
+import { afterEach, describe, expect, it } from 'vitest';
+import fs from 'node:fs';
+import path from 'node:path';
+import { tmpdir } from 'node:os';
+import { createCrashArtifactWriter } from '../crash-artifacts.js';
+describe('createCrashArtifactWriter', () => {
+    const rootDir = fs.mkdtempSync(path.join(tmpdir(), 'rn-harness-crash-artifacts-'));
+    afterEach(() => {
+        fs.rmSync(rootDir, { recursive: true, force: true });
+        fs.mkdirSync(rootDir, { recursive: true });
+    });
+    it('uses a shared run timestamp and preserves useful file extensions', () => {
+        const sourcePath = path.join(rootDir, 'Harness Playground 01.crash');
+        fs.writeFileSync(sourcePath, 'crash data', 'utf8');
+        const writer = createCrashArtifactWriter({
+            runnerName: 'ios simulator',
+            platformId: 'ios',
+            rootDir,
+            runTimestamp: '2026-03-12T11-35-08-000Z',
+        });
+        const persistedPath = writer.persistArtifact({
+            artifactKind: 'ios-crash-report',
+            source: {
+                kind: 'file',
+                path: sourcePath,
+            },
+        });
+        expect(path.basename(persistedPath)).toBe('2026-03-12T11-35-08-000Z--ios-simulator--ios--ios-crash-report--Harness-Playground-01.crash');
+        expect(fs.readFileSync(persistedPath, 'utf8')).toBe('crash data');
+        expect(writer.runTimestamp).toBe('2026-03-12T11-35-08-000Z');
+    });
+    it('creates the artifact directory lazily and writes text artifacts', () => {
+        const artifactRoot = path.join(rootDir, '.harness', 'crash-reports');
+        const writer = createCrashArtifactWriter({
+            runnerName: 'android',
+            platformId: 'android',
+            rootDir: artifactRoot,
+            runTimestamp: '2026-03-12T11-35-08-000Z',
+        });
+        const persistedPath = writer.persistArtifact({
+            artifactKind: 'logcat',
+            source: {
+                kind: 'text',
+                fileName: 'logcat.txt',
+                text: '--------- beginning of crash\nRuntimeException: boom\n',
+            },
+        });
+        expect(fs.existsSync(artifactRoot)).toBe(true);
+        expect(fs.readFileSync(persistedPath, 'utf8')).toContain('RuntimeException');
+    });
+    it('deduplicates repeated persistence requests within one run', () => {
+        const sourcePath = path.join(rootDir, 'duplicate.crash');
+        fs.writeFileSync(sourcePath, 'same crash', 'utf8');
+        const writer = createCrashArtifactWriter({
+            runnerName: 'ios',
+            platformId: 'ios',
+            rootDir,
+            runTimestamp: '2026-03-12T11-35-08-000Z',
+        });
+        const firstPath = writer.persistArtifact({
+            artifactKind: 'ios-crash-report',
+            source: {
+                kind: 'file',
+                path: sourcePath,
+            },
+        });
+        const secondPath = writer.persistArtifact({
+            artifactKind: 'ios-crash-report',
+            source: {
+                kind: 'file',
+                path: sourcePath,
+            },
+        });
+        expect(firstPath).toBe(secondPath);
+        expect(fs.readdirSync(rootDir)).toHaveLength(2);
+    });
+});

package/dist/abort.d.ts

@@ -1,2 +1,4 @@
 export declare const getTimeoutSignal: (timeout: number) => AbortSignal;
+export declare const raceAbortSignals: (signals: AbortSignal[]) => AbortSignal;
+export declare const withAbortTimeout: (signal: AbortSignal, timeout: number) => AbortSignal;
 //# sourceMappingURL=abort.d.ts.map

package/dist/abort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,KAAG,WAIlD,CAAC"}
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../src/abort.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,KAAG,WAElD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,SAAS,WAAW,EAAE,KAAG,WAKzD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,WAAW,EACnB,SAAS,MAAM,KACd,WAEF,CAAC"}

package/dist/abort.js

@@ -1,5 +1,12 @@
 export const getTimeoutSignal = (timeout) => {
-    const controller = new AbortController();
-    setTimeout(() => controller.abort(), timeout);
-    return controller.signal;
+    return AbortSignal.timeout(timeout);
+};
+export const raceAbortSignals = (signals) => {
+    if (signals.length === 0) {
+        return new AbortController().signal;
+    }
+    return AbortSignal.any(signals);
+};
+export const withAbortTimeout = (signal, timeout) => {
+    return raceAbortSignals([signal, getTimeoutSignal(timeout)]);
 };

package/dist/crash-artifacts.d.ts

@@ -0,0 +1,20 @@
+export declare const createCrashArtifactWriter: ({ runnerName, platformId, rootDir, runTimestamp, }: {
+    runnerName: string;
+    platformId: string;
+    rootDir?: string;
+    runTimestamp?: string;
+}) => {
+    runTimestamp: string;
+    persistArtifact: (options: {
+        artifactKind: string;
+        source: {
+            kind: "file";
+            path: string;
+        } | {
+            kind: "text";
+            fileName: string;
+            text: string;
+        };
+    }) => string;
+};
+//# sourceMappingURL=crash-artifacts.d.ts.map

package/dist/crash-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crash-artifacts.d.ts","sourceRoot":"","sources":["../src/crash-artifacts.ts"],"names":[],"mappings":"AA4EA,eAAO,MAAM,yBAAyB,GAAI,oDAKvC;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;;+BAK8B;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EACF;YACE,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;SACd,GACD;YACE,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,EAAE,MAAM,CAAC;YACjB,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACP;CAoCJ,CAAC"}

package/dist/crash-artifacts.js

@@ -0,0 +1,57 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const DEFAULT_ARTIFACT_ROOT = path.join(process.cwd(), '.harness', 'crash-reports');
+const sanitizePathSegment = (value) => value
+    .replace(/[^a-zA-Z0-9._-]+/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '') || 'artifact';
+const formatRunTimestamp = (value) => value.toISOString().replace(/[:.]/g, '-');
+const getTargetFileName = ({ runTimestamp, runnerName, platformId, artifactKind, source, }) => {
+    const originalName = source.kind === 'file' ? path.basename(source.path) : source.fileName;
+    return [
+        sanitizePathSegment(runTimestamp),
+        sanitizePathSegment(runnerName),
+        sanitizePathSegment(platformId),
+        sanitizePathSegment(artifactKind),
+        sanitizePathSegment(originalName),
+    ].join('--');
+};
+const getDeduplicationKey = ({ platformId, artifactKind, source, }) => {
+    if (source.kind === 'file') {
+        return `file:${platformId}:${artifactKind}:${path.resolve(source.path)}`;
+    }
+    return `text:${platformId}:${artifactKind}:${source.fileName}:${source.text}`;
+};
+export const createCrashArtifactWriter = ({ runnerName, platformId, rootDir = DEFAULT_ARTIFACT_ROOT, runTimestamp = formatRunTimestamp(new Date()), }) => {
+    const persistedArtifacts = new Map();
+    return {
+        runTimestamp,
+        persistArtifact: (options) => {
+            const deduplicationKey = getDeduplicationKey({
+                platformId,
+                artifactKind: options.artifactKind,
+                source: options.source,
+            });
+            const existingPath = persistedArtifacts.get(deduplicationKey);
+            if (existingPath) {
+                return existingPath;
+            }
+            fs.mkdirSync(rootDir, { recursive: true });
+            const targetPath = path.join(rootDir, getTargetFileName({
+                runTimestamp,
+                runnerName,
+                platformId,
+                artifactKind: options.artifactKind,
+                source: options.source,
+            }));
+            if (options.source.kind === 'file') {
+                fs.copyFileSync(options.source.path, targetPath);
+            }
+            else {
+                fs.writeFileSync(targetPath, options.source.text, 'utf8');
+            }
+            persistedArtifacts.set(deduplicationKey, targetPath);
+            return targetPath;
+        },
+    };
+};

package/dist/index.d.ts

@@ -7,4 +7,6 @@ export * from './react-native.js';
 export * from './error.js';
 export * from './events.js';
 export * from './packages.js';
+export * from './crash-artifacts.js';
+export * from './regex.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,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -7,3 +7,5 @@ export * from './react-native.js';
 export * from './error.js';
 export * from './events.js';
 export * from './packages.js';
+export * from './crash-artifacts.js';
+export * from './regex.js';

package/dist/logger.d.ts

@@ -1,11 +1,16 @@
-export declare const logger: {
-    success: (...messages: Array<unknown>) => void;
-    info: (...messages: Array<unknown>) => void;
-    warn: (...messages: Array<unknown>) => void;
-    error: (...messages: Array<unknown>) => void;
-    debug: (...messages: Array<unknown>) => void;
-    log: (...messages: Array<unknown>) => void;
+type LoggerMethod = (...messages: Array<unknown>) => void;
+export type HarnessLogger = {
+    debug: LoggerMethod;
+    info: LoggerMethod;
+    warn: LoggerMethod;
+    error: LoggerMethod;
+    log: LoggerMethod;
+    success: LoggerMethod;
+    child: (scope: string) => HarnessLogger;
     setVerbose: (level: boolean) => void;
     isVerbose: () => boolean;
 };
+export declare const createLogger: (scope: string) => HarnessLogger;
+export declare const logger: HarnessLogger;
+export {};
 //# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAwDA,eAAO,MAAM,MAAM;2BA1CW,KAAK,CAAC,OAAO,CAAC;wBAKjB,KAAK,CAAC,OAAO,CAAC;wBAKd,KAAK,CAAC,OAAO,CAAC;yBAKb,KAAK,CAAC,OAAO,CAAC;yBAUd,KAAK,CAAC,OAAO,CAAC;uBALhB,KAAK,CAAC,OAAO,CAAC;wBAcb,OAAO;;CAiBjC,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAKA,KAAK,YAAY,GAAG,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,GAAG,EAAE,YAAY,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,aAAa,CAAC;IACxC,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B,CAAC;AA6EF,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,aAChB,CAAC;AAE9B,eAAO,MAAM,MAAM,eAAuB,CAAC"}

package/dist/logger.js

@@ -1,38 +1,30 @@
 import util from 'node:util';
-import { log as clackLog } from '@clack/prompts';
-import isUnicodeSupported from 'is-unicode-supported';
-import { color } from './color.js';
-const unicode = isUnicodeSupported();
-const unicodeWithFallback = (c, fallback) => unicode ? c : fallback;
-const SYMBOL_DEBUG = unicodeWithFallback('●', '•');
 let verbose = !!process.env.HARNESS_DEBUG;
-const success = (...messages) => {
+const BASE_TAG = '[harness]';
+const getTimestamp = () => new Date().toISOString();
+const normalizeScope = (scope) => scope
+    .trim()
+    .replace(/^\[+|\]+$/g, '')
+    .replace(/\]\[/g, '][');
+const formatPrefix = (scopes) => {
+    const suffix = scopes.map((scope) => `[${normalizeScope(scope)}]`).join('');
+    return `${BASE_TAG}${suffix}`;
+};
+const mapLines = (text, prefix) => text
+    .split('\n')
+    .map((line) => `${prefix} ${line}`)
+    .join('\n');
+const writeLog = (level, scopes, messages) => {
+    const method = level === 'warn'
+        ? console.warn
+        : level === 'error'
+            ? console.error
+            : level === 'debug'
+                ? console.debug
+                : console.info;
     const output = util.format(...messages);
-    clackLog.success(output);
-};
-const info = (...messages) => {
-    const output = util.format(...messages);
-    clackLog.info(output);
-};
-const warn = (...messages) => {
-    const output = util.format(...messages);
-    clackLog.warn(mapLines(output, color.yellow));
-};
-const error = (...messages) => {
-    const output = util.format(...messages);
-    clackLog.error(mapLines(output, color.red));
-};
-const log = (...messages) => {
-    const output = util.format(...messages);
-    clackLog.step(output);
-};
-const debug = (...messages) => {
-    if (verbose) {
-        const output = util.format(...messages);
-        clackLog.message(mapLines(output, color.dim), {
-            symbol: color.dim(SYMBOL_DEBUG),
-        });
-    }
+    const prefix = `${getTimestamp()} ${formatPrefix(scopes)}`;
+    method(mapLines(output, prefix));
 };
 const setVerbose = (level) => {
     verbose = level;
@@ -40,16 +32,31 @@ const setVerbose = (level) => {
 const isVerbose = () => {
     return verbose;
 };
-export const logger = {
-    success,
-    info,
-    warn,
-    error,
-    debug,
-    log,
+const createScopedLogger = (scopes = []) => ({
+    debug: (...messages) => {
+        if (!verbose) {
+            return;
+        }
+        writeLog('debug', scopes, messages);
+    },
+    info: (...messages) => {
+        writeLog('info', scopes, messages);
+    },
+    warn: (...messages) => {
+        writeLog('warn', scopes, messages);
+    },
+    error: (...messages) => {
+        writeLog('error', scopes, messages);
+    },
+    log: (...messages) => {
+        writeLog('log', scopes, messages);
+    },
+    success: (...messages) => {
+        writeLog('success', scopes, messages);
+    },
+    child: (scope) => createScopedLogger([...scopes, scope]),
     setVerbose,
     isVerbose,
-};
-function mapLines(text, colorFn) {
-    return text.split('\n').map(colorFn).join('\n');
-}
+});
+export const createLogger = (scope) => createScopedLogger([scope]);
+export const logger = createScopedLogger();

package/dist/regex.d.ts

@@ -0,0 +1,2 @@
+export declare const escapeRegExp: (value: string) => string;
+//# sourceMappingURL=regex.d.ts.map

package/dist/regex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex.d.ts","sourceRoot":"","sources":["../src/regex.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,WACI,CAAC"}

package/dist/regex.js

@@ -0,0 +1 @@
+export const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');

package/dist/spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtD,OAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGxD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;AAEnC,eAAO,MAAM,KAAK,GAChB,MAAM,MAAM,EACZ,OAAO,SAAS,MAAM,EAAE,EACxB,UAAU,YAAY,KACrB,UAaF,CAAC;AAEF,eAAO,MAAM,cAAc,GAAU,MAAM,MAAM,EAAE,OAAO,SAAS,MAAM,EAAE,EAAE,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAMjH,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../src/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACtD,OAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGxD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;AAGnC,eAAO,MAAM,KAAK,GAChB,MAAM,MAAM,EACZ,OAAO,SAAS,MAAM,EAAE,EACxB,UAAU,YAAY,KACrB,UAcF,CAAC;AAEF,eAAO,MAAM,cAAc,GAAU,MAAM,MAAM,EAAE,OAAO,SAAS,MAAM,EAAE,EAAE,UAAU,YAAY,KAAG,OAAO,CAAC,IAAI,CAMjH,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC"}

package/dist/spawn.js

@@ -1,5 +1,6 @@
 import nanoSpawn, { SubprocessError } from 'nano-spawn';
 import { logger } from './logger.js';
+const spawnLogger = logger.child('spawn');
 export const spawn = (file, args, options) => {
     const defaultStream = 'pipe';
     const defaultOptions = {
@@ -8,7 +9,8 @@ export const spawn = (file, args, options) => {
         // Always 'pipe' stderr to handle errors properly down the line
         stderr: 'pipe',
     };
-    logger.debug(`Running: ${file}`, ...(args ?? []));
+    const command = [file, ...(args ?? [])].join(' ');
+    spawnLogger.debug('running command: %s', command);
     const childProcess = nanoSpawn(file, args, { ...defaultOptions, ...options });
     setupChildProcessCleanup(childProcess);
     return childProcess;
@@ -22,6 +24,35 @@ export const spawnAndForget = async (file, args, options) => {
     }
 };
 export { SubprocessError };
+const activeChildProcesses = new Set();
+let isProcessCleanupInstalled = false;
+const terminateActiveChildren = async () => {
+    const children = [...activeChildProcesses];
+    await Promise.allSettled(children.map(async (childProcess) => {
+        try {
+            (await childProcess.nodeChildProcess).kill();
+        }
+        catch {
+            // Ignore cleanup failures while shutting down.
+        }
+    }));
+};
+const installProcessCleanup = () => {
+    if (isProcessCleanupInstalled) {
+        return;
+    }
+    isProcessCleanupInstalled = true;
+    const terminate = async () => {
+        await terminateActiveChildren();
+        process.exit(1);
+    };
+    process.on('SIGINT', () => {
+        void terminate();
+    });
+    process.on('SIGTERM', () => {
+        void terminate();
+    });
+};
 const setupChildProcessCleanup = (childProcess) => {
     // https://stackoverflow.com/questions/53049939/node-daemon-wont-start-with-process-stdin-setrawmodetrue/53050098#53050098
     if (process.stdin.isTTY) {
@@ -29,22 +60,10 @@ const setupChildProcessCleanup = (childProcess) => {
         // which prevents listening for SIGINT and SIGTERM
         process.stdin.setRawMode(false);
     }
-    const terminate = async () => {
-        try {
-            (await childProcess.nodeChildProcess).kill();
-            process.exit(1);
-        }
-        catch {
-            // ignore
-        }
-    };
-    const sigintHandler = () => terminate();
-    const sigtermHandler = () => terminate();
-    process.on('SIGINT', sigintHandler);
-    process.on('SIGTERM', sigtermHandler);
+    installProcessCleanup();
+    activeChildProcesses.add(childProcess);
     const cleanup = () => {
-        process.off('SIGINT', sigintHandler);
-        process.off('SIGTERM', sigtermHandler);
+        activeChildProcesses.delete(childProcess);
     };
     childProcess.nodeChildProcess.finally(cleanup);
 };