@mikeyt23/node-cli-utils 1.4.1 → 2.0.0-beta.1

package/dist/cjs/generalUtilsInternal.d.ts

@@ -0,0 +1,9 @@
+import { SpawnOptionsWithThrow, SpawnResult, StringKeyedDictionary } from './generalUtils.js';
+export declare function copyEnv(sourcePath: string, destinationPath: string, overrideExistingDestinationValues?: boolean, suppressAddKeysMessages?: boolean): Promise<void>;
+export declare function getEnvAsDictionary(envPath: string): StringKeyedDictionary;
+export declare function dictionaryToEnvFileString(dict: StringKeyedDictionary): string;
+export interface SpawnOptionsInternal extends SpawnOptionsWithThrow {
+    isLongRunning?: boolean;
+}
+export declare function spawnAsyncInternal(command: string, args?: string[], options?: SpawnOptionsInternal): Promise<SpawnResult>;
+//# sourceMappingURL=generalUtilsInternal.d.ts.map

package/dist/cjs/generalUtilsInternal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generalUtilsInternal.d.ts","sourceRoot":"","sources":["../../src/generalUtilsInternal.ts"],"names":[],"mappings":"AAKA,OAAO,EAAc,qBAAqB,EAAE,WAAW,EAAE,qBAAqB,EAA8G,MAAM,mBAAmB,CAAA;AAOrN,wBAAsB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,iCAAiC,UAAO,EAAE,uBAAuB,UAAQ,iBAuCnJ;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAUzE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAE7E;AAED,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAmG/H"}

package/dist/cjs/generalUtilsInternal.js

@@ -0,0 +1,217 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spawnAsyncInternal = exports.dictionaryToEnvFileString = exports.getEnvAsDictionary = exports.copyEnv = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const NodeCliUtilsConfig_js_1 = require("./NodeCliUtilsConfig.js");
+const generalUtils_js_1 = require("./generalUtils.js");
+const isCommonJS = typeof require === "function" && typeof module === "object" && module.exports;
+const isEsm = !isCommonJS;
+const spawnWorkaroundScriptName = 'runWhileParentAlive.js';
+const currentModuleDir = ''; // Lazy loaded in getCurrentModuleDir
+async function copyEnv(sourcePath, destinationPath, overrideExistingDestinationValues = true, suppressAddKeysMessages = false) {
+    (0, generalUtils_js_1.requireValidPath)('sourcePath', sourcePath);
+    // If the destination .env file doesn't exist, just copy it and return
+    if (!node_fs_1.default.existsSync(destinationPath)) {
+        (0, generalUtils_js_1.log)(`creating ${destinationPath} from ${sourcePath}`);
+        await promises_1.default.copyFile(sourcePath, destinationPath);
+        return;
+    }
+    const sourceDict = getEnvAsDictionary(sourcePath);
+    const destinationDict = getEnvAsDictionary(destinationPath);
+    // Determine what keys are missing from destinationPath .env that are in sourcePath .env or .env.template
+    const templateKeys = Object.keys(sourceDict);
+    const destinationKeysBeforeChanging = Object.keys(destinationDict);
+    const keysMissingInDestination = templateKeys.filter(envKey => !destinationKeysBeforeChanging.includes(envKey));
+    if (keysMissingInDestination.length > 0) {
+        if (!suppressAddKeysMessages) {
+            (0, generalUtils_js_1.log)(`adding missing keys in ${destinationPath}: ${keysMissingInDestination.join(', ')}`);
+        }
+    }
+    // For instances where both .env files have the same key, use the value from the source if
+    // overrideExistingDestinationValues param is true, otherwise leave the value from the destination intact.
+    const newDict = {};
+    for (const [key, value] of Object.entries(overrideExistingDestinationValues ? sourceDict : destinationDict)) {
+        newDict[key] = value;
+    }
+    // Add entries that the destination doesn't have yet
+    for (const key of keysMissingInDestination) {
+        newDict[key] = sourceDict[key];
+    }
+    const newSortedDict = (0, generalUtils_js_1.sortDictionaryByKeyAsc)(newDict);
+    const newEnvFileContent = dictionaryToEnvFileString(newSortedDict);
+    await promises_1.default.writeFile(destinationPath, newEnvFileContent);
+}
+exports.copyEnv = copyEnv;
+function getEnvAsDictionary(envPath) {
+    const dict = {};
+    const lines = (0, generalUtils_js_1.stringToNonEmptyLines)(node_fs_1.default.readFileSync(envPath).toString());
+    for (const line of lines) {
+        if (line && line.indexOf('=') !== -1) {
+            const parts = line.split('=');
+            dict[parts[0].trim()] = parts[1].trim();
+        }
+    }
+    return dict;
+}
+exports.getEnvAsDictionary = getEnvAsDictionary;
+function dictionaryToEnvFileString(dict) {
+    return Object.entries(dict).map(kvp => `${kvp[0]}=${kvp[1]}`).join('\n') + '\n';
+}
+exports.dictionaryToEnvFileString = dictionaryToEnvFileString;
+async function spawnAsyncInternal(command, args, options) {
+    const moduleDir = await getCurrentModuleDir();
+    return new Promise((resolve, reject) => {
+        var _a, _b, _c, _d;
+        try {
+            const defaultSpawnOptions = { stdio: 'inherit' };
+            const argsForChildProcess = args !== null && args !== void 0 ? args : [];
+            const logPrefix = `[${command} ${argsForChildProcess.join(' ')}] `;
+            const mergedOptions = { ...defaultSpawnOptions, ...options };
+            const result = {
+                code: 1,
+                stdout: '',
+                stderr: '',
+                cwd: (_b = (_a = mergedOptions.cwd) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : process.cwd()
+            };
+            // Windows has an issue where child processes are orphaned when using the shell option. This workaround will spawn
+            // a "middle" process using the shell option to check whether parent process is still running at intervals and if not, kill the child process tree.
+            const workaroundCommand = 'node';
+            const workaroundScriptPath = node_path_1.default.join(moduleDir, spawnWorkaroundScriptName);
+            // First check if this is the request for the workaround process itself
+            if ((options === null || options === void 0 ? void 0 : options.isLongRunning) && (0, generalUtils_js_1.isPlatformWindows)() && command !== workaroundCommand && (!argsForChildProcess[0] || !argsForChildProcess[0].endsWith(spawnWorkaroundScriptName))) {
+                (0, generalUtils_js_1.trace)(`${logPrefix}Running on Windows with shell option - using middle process hack to prevent orphaned processes`);
+                const loggingEnabledString = NodeCliUtilsConfig_js_1.config.orphanProtectionLoggingEnabled.toString();
+                const traceEnabledString = NodeCliUtilsConfig_js_1.config.traceEnabled.toString();
+                const pollingMillisString = NodeCliUtilsConfig_js_1.config.orphanProtectionPollingIntervalMillis.toString();
+                (0, generalUtils_js_1.trace)(`${logPrefix}Orphan protection logging enabled: ${loggingEnabledString}`);
+                (0, generalUtils_js_1.trace)(`${logPrefix}Orphan protection trace enabled: ${traceEnabledString}`);
+                (0, generalUtils_js_1.trace)(`${logPrefix}Orphan protection polling interval: ${pollingMillisString}ms`);
+                if (NodeCliUtilsConfig_js_1.config.orphanProtectionLoggingEnabled) {
+                    (0, generalUtils_js_1.trace)(`${logPrefix}Orphan protection logging path: ${NodeCliUtilsConfig_js_1.config.orphanProtectionLoggingPath}`);
+                }
+                const workaroundArgs = [
+                    workaroundScriptPath,
+                    loggingEnabledString,
+                    traceEnabledString,
+                    pollingMillisString,
+                    command,
+                    ...(args !== null && args !== void 0 ? args : [])
+                ];
+                (0, generalUtils_js_1.spawnAsync)(workaroundCommand, workaroundArgs, { ...mergedOptions, stdio: 'inherit', shell: true })
+                    .then((workaroundResult) => {
+                    result.code = workaroundResult.code;
+                    if ((options === null || options === void 0 ? void 0 : options.throwOnNonZero) && result.code !== 0) {
+                        reject(getSpawnError(result.code, result, options));
+                        return;
+                    }
+                    resolve(result);
+                }).catch((err) => {
+                    reject(err);
+                });
+                return;
+            }
+            const child = (0, node_child_process_1.spawn)(command, argsForChildProcess, mergedOptions);
+            const childId = child.pid;
+            if (childId === undefined) {
+                throw new Error(`${logPrefix}ChildProcess pid is undefined - spawn failed`);
+            }
+            // This event will only be emitted when stdio is NOT set to 'inherit'
+            (_c = child.stdout) === null || _c === void 0 ? void 0 : _c.on('data', (data) => {
+                process.stdout.write(data);
+                result.stdout += data.toString();
+            });
+            // This event will only be emitted when stdio is NOT set to 'inherit'
+            (_d = child.stderr) === null || _d === void 0 ? void 0 : _d.on('data', (data) => {
+                process.stdout.write(data);
+                result.stderr += data.toString();
+            });
+            const listener = new SignalListener(child, logPrefix);
+            child.on('exit', (code, signal) => {
+                const signalMessage = signal ? ` with signal ${signal}` : '';
+                (0, generalUtils_js_1.trace)(`${logPrefix}ChildProcess exited with code ${code}${signalMessage}`);
+                // If long running, ctrl+c will cause null, which we don't necessarily want to consider an error
+                result.code = (code === null && (options === null || options === void 0 ? void 0 : options.isLongRunning)) ? 0 : code !== null && code !== void 0 ? code : 1;
+                child.removeAllListeners();
+                listener.detach();
+                if ((options === null || options === void 0 ? void 0 : options.throwOnNonZero) && result.code !== 0) {
+                    reject(getSpawnError(result.code, result, mergedOptions));
+                    return;
+                }
+                resolve(result);
+            });
+            child.on('error', (error) => {
+                (0, generalUtils_js_1.trace)(`${logPrefix}ChildProcess emitted an error event: `, error);
+            });
+        }
+        catch (err) {
+            reject(err);
+        }
+    });
+}
+exports.spawnAsyncInternal = spawnAsyncInternal;
+function getSpawnError(code, result, options) {
+    const additional = options.throwOnNonZero && options.stdio === 'inherit' ? `. See above for more details (stdio is 'inherit').` : '';
+    return new generalUtils_js_1.SpawnError(`Spawning child process failed with code ${code}${additional}`, result);
+}
+class SignalListener {
+    constructor(child, logPrefix) {
+        this.signals = ['SIGINT', 'SIGTERM', 'SIGQUIT'];
+        // Arrow function provides unique handler function for each instance of SignalListener
+        this.handler = (signal) => {
+            (0, generalUtils_js_1.trace)(`${this.logPrefix}Process received ${signal} - killing ChildProcess with ID ${this.child.pid}`);
+            this.child.kill(signal);
+            this.detach();
+        };
+        this.child = child;
+        this.logPrefix = logPrefix;
+        this.attach();
+    }
+    attach() {
+        this.signals.forEach(signal => process.on(signal, this.handler));
+    }
+    detach() {
+        this.signals.forEach(signal => process.removeListener(signal, this.handler));
+    }
+}
+async function getCurrentModuleDir() {
+    if (currentModuleDir) {
+        return currentModuleDir;
+    }
+    if (isEsm) {
+        const module = await Promise.resolve().then(() => __importStar(require('./esmSpecific.mjs')));
+        const metaUrlFilePath = module.getImportMetaUrlFilePath();
+        const directory = node_path_1.default.dirname(metaUrlFilePath);
+        return node_path_1.default.normalize(directory);
+    }
+    return __dirname;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2VuZXJhbFV0aWxzSW50ZXJuYWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZ2VuZXJhbFV0aWxzSW50ZXJuYWwudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSwyREFBc0U7QUFDdEUsc0RBQXdCO0FBQ3hCLGdFQUFrQztBQUNsQywwREFBNEI7QUFDNUIsbUVBQWdEO0FBQ2hELHVEQUFxTjtBQUVyTixNQUFNLFVBQVUsR0FBRyxPQUFPLE9BQU8sS0FBSyxVQUFVLElBQUksT0FBTyxNQUFNLEtBQUssUUFBUSxJQUFJLE1BQU0sQ0FBQyxPQUFPLENBQUE7QUFDaEcsTUFBTSxLQUFLLEdBQUcsQ0FBQyxVQUFVLENBQUE7QUFDekIsTUFBTSx5QkFBeUIsR0FBRyx3QkFBd0IsQ0FBQTtBQUMxRCxNQUFNLGdCQUFnQixHQUFXLEVBQUUsQ0FBQSxDQUFDLHFDQUFxQztBQUVsRSxLQUFLLFVBQVUsT0FBTyxDQUFDLFVBQWtCLEVBQUUsZUFBdUIsRUFBRSxpQ0FBaUMsR0FBRyxJQUFJLEVBQUUsdUJBQXVCLEdBQUcsS0FBSztJQUNsSixJQUFBLGtDQUFnQixFQUFDLFlBQVksRUFBRSxVQUFVLENBQUMsQ0FBQTtJQUUxQyxzRUFBc0U7SUFDdEUsSUFBSSxDQUFDLGlCQUFFLENBQUMsVUFBVSxDQUFDLGVBQWUsQ0FBQyxFQUFFO1FBQ25DLElBQUEscUJBQUcsRUFBQyxZQUFZLGVBQWUsU0FBUyxVQUFVLEVBQUUsQ0FBQyxDQUFBO1FBQ3JELE1BQU0sa0JBQUcsQ0FBQyxRQUFRLENBQUMsVUFBVSxFQUFFLGVBQWUsQ0FBQyxDQUFBO1FBQy9DLE9BQU07S0FDUDtJQUVELE1BQU0sVUFBVSxHQUFHLGtCQUFrQixDQUFDLFVBQVUsQ0FBQyxDQUFBO0lBQ2pELE1BQU0sZUFBZSxHQUFHLGtCQUFrQixDQUFDLGVBQWUsQ0FBQyxDQUFBO0lBRTNELHlHQUF5RztJQUN6RyxNQUFNLFlBQVks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

package/dist/cjs/index.d.ts

@@ -0,0 +1,4 @@
+export * from './generalUtils.js';
+export { config } from './NodeCliUtilsConfig.js';
+export { createTarball, unpackTarball, unpackTarballContents } from './TarballUtility.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/cjs/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unpackTarballContents = exports.unpackTarball = exports.createTarball = exports.config = void 0;
+__exportStar(require("./generalUtils.js"), exports);
+var NodeCliUtilsConfig_js_1 = require("./NodeCliUtilsConfig.js");
+Object.defineProperty(exports, "config", { enumerable: true, get: function () { return NodeCliUtilsConfig_js_1.config; } });
+var TarballUtility_js_1 = require("./TarballUtility.js");
+Object.defineProperty(exports, "createTarball", { enumerable: true, get: function () { return TarballUtility_js_1.createTarball; } });
+Object.defineProperty(exports, "unpackTarball", { enumerable: true, get: function () { return TarballUtility_js_1.unpackTarball; } });
+Object.defineProperty(exports, "unpackTarballContents", { enumerable: true, get: function () { return TarballUtility_js_1.unpackTarballContents; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxvREFBaUM7QUFDakMsaUVBQWdEO0FBQXZDLCtHQUFBLE1BQU0sT0FBQTtBQUNmLHlEQUF5RjtBQUFoRixrSEFBQSxhQUFhLE9BQUE7QUFBRSxrSEFBQSxhQUFhLE9BQUE7QUFBRSwwSEFBQSxxQkFBcUIsT0FBQSJ9

package/dist/cjs/package.json

@@ -0,0 +1,5 @@
+{
+  "type": "commonjs",
+  "main": "./index.cjs",
+  "types": "./index.d.ts"
+}

package/dist/cjs/runWhileParentAlive.d.ts

@@ -0,0 +1,2 @@
+export declare function trace(message?: unknown, ...optionalParams: unknown[]): void;
+//# sourceMappingURL=runWhileParentAlive.d.ts.map

package/dist/cjs/runWhileParentAlive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runWhileParentAlive.d.ts","sourceRoot":"","sources":["../../src/runWhileParentAlive.ts"],"names":[],"mappings":"AAqBA,wBAAgB,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,QAGpE"}

package/dist/cjs/runWhileParentAlive.js

@@ -0,0 +1,161 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trace = void 0;
+// runWhileParentAlive.ts
+// Also referred to as "orphan protection" or "long running windows process workaround script"
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const NodeCliUtilsConfig_js_1 = require("./NodeCliUtilsConfig.js");
+const DEV_LOGGING = false; // Set to true while developing this script to see more logging in the console
+let loggingEnabled = true; // Will be set below by process.argv[2] === 'true' from spawnAsync in generalUtils.js
+let traceEnabled = true; // Will be set below by process.argv[3] === 'true' from spawnAsync in generalUtils.js
+let pollingMillis = NodeCliUtilsConfig_js_1.config.orphanProtectionPollingIntervalMillis; // Will be set by process.argv[4] from spawnAsync in generalUtils.js
+function getLogPrefix() {
+    const now = new Date();
+    const hours = now.getHours().toString().padStart(2, '0');
+    const minutes = now.getMinutes().toString().padStart(2, '0');
+    const seconds = now.getSeconds().toString().padStart(2, '0');
+    const milliseconds = now.getMilliseconds().toString().padStart(3, '0');
+    return `[${hours}:${minutes}:${seconds}:${milliseconds}] `;
+}
+// Using this trace method instead of importing from generalUtils.js since config is not shared between processes
+function trace(message, ...optionalParams) {
+    const prefix = `[TRACE]`;
+    console.log(prefix, message, ...optionalParams);
+}
+exports.trace = trace;
+function logToFile(message) {
+    node_fs_1.default.appendFileSync(NodeCliUtilsConfig_js_1.config.orphanProtectionLoggingPath, `${getLogPrefix()}${message}` + ((message && message.length && message[message.length - 1] !== '\n') ? '\n' : ''));
+}
+function traceAndLog(message, isDevTrace = false) {
+    if (isDevTrace && !DEV_LOGGING) {
+        return;
+    }
+    if (isDevTrace && DEV_LOGGING) {
+        trace(getLogPrefix() + message);
+        logToFile(message);
+        return;
+    }
+    if (traceEnabled) {
+        trace(getLogPrefix() + message);
+    }
+    if (loggingEnabled) {
+        logToFile(message);
+    }
+}
+function isParentProcessAlive(parentId) {
+    var _a, _b, _c;
+    try {
+        const result = (0, node_child_process_1.spawnSync)('tasklist', { shell: true });
+        const resultToLog = {
+            status: result.status,
+            stderr: (_a = result.stderr) === null || _a === void 0 ? void 0 : _a.toString(),
+            stdoutIncludesParentId: (_c = (_b = result.stdout) === null || _b === void 0 ? void 0 : _b.toString().includes(parentId.toString())) !== null && _c !== void 0 ? _c : false
+        };
+        traceAndLog('tasklist result: ' + JSON.stringify(resultToLog), true);
+        return resultToLog.stdoutIncludesParentId;
+    }
+    catch (err) {
+        if (err instanceof Error) {
+            console.log(err.message);
+            console.log(err.stack);
+        }
+        else {
+            console.error(err);
+        }
+        traceAndLog(`Error attempting to fetch task list using 'tasklist' - returning false for isParentAlive(): ${err instanceof Error ? err.toString() : err}`);
+        return false;
+    }
+}
+function killTree(pid) {
+    try {
+        (0, node_child_process_1.execSync)(`taskkill /pid ${pid} /T /F`);
+        traceAndLog(`No errors running killTree`);
+    }
+    catch (err) {
+        traceAndLog(`Error running taskkill with PID ${pid}: ${err instanceof Error ? err.toString() : err}`);
+    }
+}
+try {
+    loggingEnabled = process.argv[2] === 'true';
+    traceEnabled = process.argv[3] === 'true';
+    pollingMillis = Number(process.argv[4]);
+    if (Number.isNaN(pollingMillis) || pollingMillis < 0 || pollingMillis > (3600 * 1000)) {
+        pollingMillis = NodeCliUtilsConfig_js_1.config.orphanProtectionPollingIntervalMillis;
+    }
+    const passthroughArgs = process.argv.slice(5);
+    if (loggingEnabled) {
+        traceAndLog(`Logging enabled with polling rate set to: ${pollingMillis}ms`);
+        traceAndLog(`Trace enabled: ${traceEnabled}`);
+    }
+    if (DEV_LOGGING) {
+        const argvString = JSON.stringify(process.argv);
+        console.log(argvString);
+        logToFile(argvString);
+        traceAndLog(`process.argv[2] (logging enabled): ${process.argv[2]}`, true);
+        traceAndLog(`process.argv[3]   (trace enabled): ${process.argv[3]}`, true);
+        traceAndLog(`process.argv[4]  (polling millis): ${process.argv[4]}`, true);
+        traceAndLog(`rest of process.argv: ${JSON.stringify(passthroughArgs)}`, true);
+    }
+    const parentId = process.ppid;
+    if (!parentId) {
+        const noParentIdMessage = `Middle process cannot continue - parent process id not found`;
+        console.error(noParentIdMessage);
+        traceAndLog(noParentIdMessage);
+        process.exit(1);
+    }
+    const [command, ...args] = passthroughArgs;
+    const child = (0, node_child_process_1.spawn)(command, args, { stdio: 'inherit', shell: true });
+    const childId = child.pid;
+    if (!childId) {
+        const noChildIdMessage = 'spawning ChildProcess failed - no pid on returned handle';
+        console.error(noChildIdMessage);
+        traceAndLog(noChildIdMessage);
+        process.exit(1);
+    }
+    const interval = setInterval(() => {
+        if (!isParentProcessAlive(parentId)) {
+            traceAndLog('Parent process is not alive. Shutting down.');
+            killTree(childId);
+            clearInterval(interval);
+            traceAndLog('Used taskkill and cleared interval - exiting...');
+            process.exit(0);
+        }
+        else {
+            if (DEV_LOGGING) {
+                traceAndLog('Parent is alive, keep running.');
+            }
+        }
+    }, pollingMillis);
+    child.on('exit', (code, signal) => {
+        const andSignal = signal ? ` and signal ${signal}` : '';
+        traceAndLog(`ChildProcess exit event emitted with code ${code}${andSignal} - exiting`);
+        clearInterval(interval);
+        process.exit(code !== null && code !== void 0 ? code : 1);
+    });
+    const signals = ['SIGINT', 'SIGTERM', 'SIGQUIT'];
+    signals.forEach((signal) => {
+        process.on(signal, () => {
+            traceAndLog(`Middle process received signal ${signal} - will attempt to kill child process tree, clear interval and exit`);
+            try {
+                clearInterval(interval);
+                traceAndLog(`Ran clearInterval in signal event ${signal} - exiting`);
+                process.exit(0);
+            }
+            catch (err) {
+                traceAndLog(`Error attempting to run clearInterval during signal event ${signal}: ${err instanceof Error ? err.toString() : err}`);
+                process.exit(1);
+            }
+        });
+    });
+}
+catch (err) {
+    const msg = `Unexpected error in runWhileParentAlive: ${err instanceof Error ? err.toString() : err}`;
+    console.error(msg);
+    logToFile(msg);
+    process.exit(1);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVuV2hpbGVQYXJlbnRBbGl2ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9ydW5XaGlsZVBhcmVudEFsaXZlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQUFBLHlCQUF5QjtBQUN6Qiw4RkFBOEY7QUFDOUYsMkRBQStEO0FBQy9ELHNEQUF3QjtBQUN4QixtRUFBZ0Q7QUFFaEQsTUFBTSxXQUFXLEdBQUcsS0FBSyxDQUFBLENBQUMsOEVBQThFO0FBQ3hHLElBQUksY0FBYyxHQUFHLElBQUksQ0FBQSxDQUFDLHFGQUFxRjtBQUMvRyxJQUFJLFlBQVksR0FBRyxJQUFJLENBQUEsQ0FBQyxxRkFBcUY7QUFDN0csSUFBSSxhQUFhLEdBQVcsOEJBQU0sQ0FBQyxxQ0FBcUMsQ0FBQSxDQUFDLG9FQUFvRTtBQUU3SSxTQUFTLFlBQVk7SUFDbkIsTUFBTSxHQUFHLEdBQUcsSUFBSSxJQUFJLEVBQUUsQ0FBQTtJQUN0QixNQUFNLEtBQUssR0FBRyxHQUFHLENBQUMsUUFBUSxFQUFFLENBQUMsUUFBUSxFQUFFLENBQUMsUUFBUSxDQUFDLENBQUMsRUFBRSxHQUFHLENBQUMsQ0FBQTtJQUN4RCxNQUFNLE9BQU8sR0FBRyxHQUFHLENBQUMsVUFBVSxFQUFFLENBQUMsUUFBUSxFQUFFLENBQUMsUUFBUSxDQUFDLENBQUMsRUFBRSxHQUFHLENBQUMsQ0FBQTtJQUM1RCxNQUFNLE9BQU8sR0FBRyxHQUFHLENBQUMsVUFBVSxFQUFFLENBQUMsUUFBUSxFQUFFLENBQUMsUUFBUSxDQUFDLENBQUMsRUFBRSxHQUFHLENBQUMsQ0FBQTtJQUM1RCxNQUFNLFlBQVksR0FBRyxHQUFHLENBQUMsZUFBZSxFQUFFLENBQUMsUUFBUSxFQUFFLENBQUMsUUFBUSxDQUFDLENBQUMsRUFBRSxHQUFHLENBQUMsQ0FBQTtJQUN0RSxPQUFPLElBQUksS0FBSyxJQUFJLE9BQU8sSUFBSSxPQUFPLElBQUksWUFBWSxJQUFJLENBQUE7QUFDNUQsQ0FBQztB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

package/dist/esm/NodeCliUtilsConfig.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Config to control a few misc settings in the node-cli-utils package. This module exports a singleton instance.
+ */
+export declare class NodeCliUtilsConfig {
+    private _traceEnabled;
+    private _orphanProtectionPollingIntervalMillis;
+    private _orphanProtectionLoggingEnabled;
+    private _orphanProtectionLoggingPath;
+    get traceEnabled(): boolean;
+    set traceEnabled(value: boolean);
+    get orphanProtectionPollingIntervalMillis(): number;
+    set orphanProtectionPollingIntervalMillis(value: number);
+    get orphanProtectionLoggingEnabled(): boolean;
+    set orphanProtectionLoggingEnabled(value: boolean);
+    get orphanProtectionLoggingPath(): string;
+}
+/**
+ * Singleton instance of {@link NodeCliUtilsConfig}.
+ */
+export declare const config: NodeCliUtilsConfig;
+//# sourceMappingURL=NodeCliUtilsConfig.d.ts.map

package/dist/esm/NodeCliUtilsConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeCliUtilsConfig.d.ts","sourceRoot":"","sources":["../../src/NodeCliUtilsConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,sCAAsC,CAAQ;IACtD,OAAO,CAAC,+BAA+B,CAAQ;IAC/C,OAAO,CAAC,4BAA4B,CAA2B;IAE/D,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,EAE9B;IAED,IAAI,qCAAqC,IAAI,MAAM,CAElD;IAED,IAAI,qCAAqC,CAAC,KAAK,EAAE,MAAM,EAEtD;IAED,IAAI,8BAA8B,IAAI,OAAO,CAE5C;IAED,IAAI,8BAA8B,CAAC,KAAK,EAAE,OAAO,EAEhD;IAED,IAAI,2BAA2B,IAAI,MAAM,CAExC;CACF;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,oBAA2B,CAAA"}

package/dist/esm/NodeCliUtilsConfig.js

@@ -0,0 +1,35 @@
+/**
+ * Config to control a few misc settings in the node-cli-utils package. This module exports a singleton instance.
+ */
+export class NodeCliUtilsConfig {
+    _traceEnabled = false;
+    _orphanProtectionPollingIntervalMillis = 15000;
+    _orphanProtectionLoggingEnabled = false;
+    _orphanProtectionLoggingPath = './orphanProtection.log';
+    get traceEnabled() {
+        return this._traceEnabled;
+    }
+    set traceEnabled(value) {
+        this._traceEnabled = value;
+    }
+    get orphanProtectionPollingIntervalMillis() {
+        return this._orphanProtectionPollingIntervalMillis;
+    }
+    set orphanProtectionPollingIntervalMillis(value) {
+        this._orphanProtectionPollingIntervalMillis = value;
+    }
+    get orphanProtectionLoggingEnabled() {
+        return this._orphanProtectionLoggingEnabled;
+    }
+    set orphanProtectionLoggingEnabled(value) {
+        this._orphanProtectionLoggingEnabled = value;
+    }
+    get orphanProtectionLoggingPath() {
+        return this._orphanProtectionLoggingPath;
+    }
+}
+/**
+ * Singleton instance of {@link NodeCliUtilsConfig}.
+ */
+export const config = new NodeCliUtilsConfig();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiTm9kZUNsaVV0aWxzQ29uZmlnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL05vZGVDbGlVdGlsc0NvbmZpZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUNILE1BQU0sT0FBTyxrQkFBa0I7SUFDckIsYUFBYSxHQUFZLEtBQUssQ0FBQztJQUMvQixzQ0FBc0MsR0FBRyxLQUFLLENBQUE7SUFDOUMsK0JBQStCLEdBQUcsS0FBSyxDQUFBO0lBQ3ZDLDRCQUE0QixHQUFHLHdCQUF3QixDQUFBO0lBRS9ELElBQUksWUFBWTtRQUNkLE9BQU8sSUFBSSxDQUFDLGFBQWEsQ0FBQTtJQUMzQixDQUFDO0lBRUQsSUFBSSxZQUFZLENBQUMsS0FBYztRQUM3QixJQUFJLENBQUMsYUFBYSxHQUFHLEtBQUssQ0FBQTtJQUM1QixDQUFDO0lBRUQsSUFBSSxxQ0FBcUM7UUFDdkMsT0FBTyxJQUFJLENBQUMsc0NBQXNDLENBQUE7SUFDcEQsQ0FBQztJQUVELElBQUkscUNBQXFDLENBQUMsS0FBYTtRQUNyRCxJQUFJLENBQUMsc0NBQXNDLEdBQUcsS0FBSyxDQUFBO0lBQ3JELENBQUM7SUFFRCxJQUFJLDhCQUE4QjtRQUNoQyxPQUFPLElBQUksQ0FBQywrQkFBK0IsQ0FBQTtJQUM3QyxDQUFDO0lBRUQsSUFBSSw4QkFBOEIsQ0FBQyxLQUFjO1FBQy9DLElBQUksQ0FBQywrQkFBK0IsR0FBRyxLQUFLLENBQUE7SUFDOUMsQ0FBQztJQUVELElBQUksMkJBQTJCO1FBQzdCLE9BQU8sSUFBSSxDQUFDLDRCQUE0QixDQUFBO0lBQzFDLENBQUM7Q0FDRjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sTUFBTSxHQUFHLElBQUksa0JBQWtCLEVBQUUsQ0FBQSJ9

package/dist/esm/TarballUtility.d.ts

@@ -0,0 +1,53 @@
+import { whichSync } from './generalUtils.js';
+export interface CreateTarballOptions {
+    /**
+     * A list of files or directories to exclude from the tarball.
+     * The paths should be relative to the directoryToTarball.
+     */
+    excludes?: string[];
+}
+export interface TarballUnpackOptions {
+    createDirIfNotExists?: boolean;
+    stripComponents?: number;
+    throwOnNonEmptyUnpackDir?: boolean;
+}
+/**
+ * This utility class exists so we can mock the `which` dependency in unit tests without resorting to libraries that hack the import system.
+ */
+export declare class TarballUtility {
+    private whichSyncFn;
+    constructor(whichSyncFn: typeof whichSync);
+    /**
+     * Creates a gzipped tarball from a directory by spawning a process to run OS-installed `tar` to avoid pulling in npm package dependencies.
+     * Note that Windows has tar since Windows 10 1803 (see https://devblogs.microsoft.com/commandline/windows10v1803/.
+     *
+     * It's possible this isn't 100% reliable due to differences in `tar` versions across platforms. If better normalization
+     * is required, consider using the npm package `node-tar` instead.
+     * @param directoryToTarball The directory to tarball. The directory name will be used as the root directory in the tarball
+     * @param tarballPath The path to the tarball to create - must end with '.tar.gz'
+     * @param options See {@link CreateTarballOptions}
+     */
+    createTarball: (directoryToTarball: string, tarballPath: string, options?: CreateTarballOptions) => Promise<void>;
+    /**
+     * Unpacks a gzipped tarball by spawning a process to run OS-installed `tar` to avoid pulling in npm package dependencies.
+     * This method will throw an error if the unpackDirectory is not empty, unless the `throwOnNonEmptyUnpackDir` option is set to false.
+     * @param tarballPath The path to the tarball to unpack
+     * @param unpackDirectory The directory to unpack the tarball into
+     * @param options The options to use when unpacking the tarball. See {@link TarballUnpackOptions}.
+     */
+    unpackTarball: (tarballPath: string, unpackDirectory: string, options?: TarballUnpackOptions) => Promise<void>;
+    /**
+     * A more opinionated version of {@link unpackTarball} that assumes you want to create the directory and strip the first directory out of the unpacked files.
+     * @param tarballPath The path to the tarball to unpack
+     * @param unpackDirectory The directory to unpack the tarball into - will be created if it doesn't exist and will throw if it exists but is not empty
+     * @param stripComponents The number of leading directories to strip out of the unpacked files, defaults to 1
+     */
+    unpackTarballContents: (tarballPath: string, unpackDirectory: string, stripComponents?: number) => Promise<void>;
+    private isDirectory;
+    private dirIsNotEmpty;
+    private tryCreateDirectory;
+}
+export declare const createTarball: (directoryToTarball: string, tarballPath: string, options?: CreateTarballOptions) => Promise<void>;
+export declare const unpackTarball: (tarballPath: string, unpackDirectory: string, options?: TarballUnpackOptions) => Promise<void>;
+export declare const unpackTarballContents: (tarballPath: string, unpackDirectory: string, stripComponents?: number) => Promise<void>;
+//# sourceMappingURL=TarballUtility.d.ts.map

package/dist/esm/TarballUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TarballUtility.d.ts","sourceRoot":"","sources":["../../src/TarballUtility.ts"],"names":[],"mappings":"AAGA,OAAO,EAA8D,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAGzG,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wBAAwB,CAAC,EAAE,OAAO,CAAA;CACnC;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAkB;gBAEzB,WAAW,EAAE,OAAO,SAAS;IAIzC;;;;;;;;;OASG;IACH,aAAa,uBAA8B,MAAM,eAAe,MAAM,YAAY,oBAAoB,mBA4CrG;IAED;;;;;;OAMG;IACH,aAAa,gBAAuB,MAAM,mBAAmB,MAAM,YAAY,oBAAoB,mBA0ClG;IAED;;;;;OAKG;IACH,qBAAqB,gBAAuB,MAAM,mBAAmB,MAAM,oBAAmB,MAAM,mBAEnG;IAED,OAAO,CAAC,WAAW,CAOlB;IAED,OAAO,CAAC,aAAa,CAOpB;IAED,OAAO,CAAC,kBAAkB,CAUzB;CACF;AAID,eAAO,MAAM,aAAa,uBA5ImB,MAAM,eAAe,MAAM,YAAY,oBAAoB,kBA4IlD,CAAA;AACtD,eAAO,MAAM,aAAa,gBAxFY,MAAM,mBAAmB,MAAM,YAAY,oBAAoB,kBAwF/C,CAAA;AACtD,eAAO,MAAM,qBAAqB,gBAvCY,MAAM,mBAAmB,MAAM,oBAAmB,MAAM,kBAuChC,CAAA"}