teen_process 2.0.3 → 2.0.5

package/build/lib/exec.d.ts

@@ -0,0 +1,108 @@
+export default exec;
+/**
+ * Options on top of `SpawnOptions`, unique to `teen_process.`
+ */
+export type TeenProcessProps = {
+    /**
+     * - Ignore & discard all output
+     */
+    ignoreOutput?: boolean | undefined;
+    /**
+     * - Return output as a Buffer
+     */
+    isBuffer?: boolean | undefined;
+    /**
+     * - Logger to use for debugging
+     */
+    logger?: TeenProcessLogger | undefined;
+    /**
+     * - Maximum size of `stdout` buffer
+     */
+    maxStdoutBufferSize?: number | undefined;
+    /**
+     * - Maximum size of `stderr` buffer
+     */
+    maxStderrBufferSize?: number | undefined;
+    /**
+     * - Encoding to use for output
+     */
+    encoding?: BufferEncoding | undefined;
+};
+/**
+ * A logger object understood by {@link exec teen_process.exec}.
+ */
+export type TeenProcessLogger = {
+    debug: (...args: any[]) => void;
+};
+/**
+ * Options for {@link exec teen_process.exec}.
+ */
+export type TeenProcessExecOptions = import('child_process').SpawnOptions & TeenProcessProps;
+/**
+ * The value {@link exec teen_process.exec} resolves to when `isBuffer` is `false`
+ */
+export type TeenProcessExecStringResult = {
+    /**
+     * - Stdout
+     */
+    stdout: string;
+    /**
+     * - Stderr
+     */
+    stderr: string;
+    /**
+     * - Exit code
+     */
+    code: number | null;
+};
+/**
+ * The value {@link exec teen_process.exec} resolves to when `isBuffer` is `true`
+ */
+export type TeenProcessExecBufferResult = {
+    /**
+     * - Stdout
+     */
+    stdout: Buffer;
+    /**
+     * - Stderr
+     */
+    stderr: Buffer;
+    /**
+     * - Exit code
+     */
+    code: number | null;
+};
+/**
+ * Extra props {@link exec teen_process.exec} adds to its error objects
+ */
+export type TeenProcessExecErrorProps = {
+    /**
+     * - STDOUT
+     */
+    stdout: string;
+    /**
+     * - STDERR
+     */
+    stderr: string;
+    /**
+     * - Exit code
+     */
+    code: number | null;
+};
+/**
+ * Error thrown by {@link exec teen_process.exec}
+ */
+export type TeenProcessExecError = Error & TeenProcessExecErrorProps;
+export type BufferProp<MaybeBuffer extends {
+    isBuffer?: boolean | undefined;
+}> = MaybeBuffer['isBuffer'];
+/**
+ * Spawns a process
+ * @template {TeenProcessExecOptions} T
+ * @param {string} cmd - Program to execute
+ * @param {string[]} [args] - Arguments to pass to the program
+ * @param {T} [opts] - Options
+ * @returns {Promise<BufferProp<T> extends true ? TeenProcessExecBufferResult : TeenProcessExecStringResult>}
+ */
+export function exec<T extends TeenProcessExecOptions>(cmd: string, args?: string[] | undefined, opts?: T | undefined): Promise<BufferProp<T> extends true ? TeenProcessExecBufferResult : TeenProcessExecStringResult>;
+//# sourceMappingURL=exec.d.ts.map

package/build/lib/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../lib/exec.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAuKwB,GAAG,EAAE,KAAK,IAAI;;;;;qCAKzB,OAAO,eAAe,EAAE,YAAY,GAAG,gBAAgB;;;;;;;;YAMtD,MAAM;;;;YACN,MAAM;;;;UACN,MAAM;;;;;;;;;YAMN,MAAM;;;;YACN,MAAM;;;;UACN,MAAM;;;;;;;;;YAMN,MAAM;;;;YACN,MAAM;;;;UACN,MAAM;;;;;mCAKP,KAAK,GAAG,yBAAyB;;;KAKjC,WAAW,CAAC,UAAU,CAAC;AApMpC;;;;;;;GAOG;AACH,4DALW,MAAM,sJAuIhB"}

package/build/lib/exec.js

@@ -0,0 +1,196 @@
+"use strict";
+/* eslint-disable promise/prefer-await-to-callbacks */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exec = void 0;
+const child_process_1 = require("child_process");
+const shell_quote_1 = require("shell-quote");
+const bluebird_1 = __importDefault(require("bluebird"));
+const lodash_1 = __importDefault(require("lodash"));
+const helpers_1 = require("./helpers");
+const MAX_BUFFER_SIZE = 100 * 1024 * 1024;
+/**
+ * Spawns a process
+ * @template {TeenProcessExecOptions} T
+ * @param {string} cmd - Program to execute
+ * @param {string[]} [args] - Arguments to pass to the program
+ * @param {T} [opts] - Options
+ * @returns {Promise<BufferProp<T> extends true ? TeenProcessExecBufferResult : TeenProcessExecStringResult>}
+ */
+async function exec(cmd, args = [], opts = /** @type {T} */ ({})) {
+    // get a quoted representation of the command for error strings
+    const rep = (0, shell_quote_1.quote)([cmd, ...args]);
+    // extend default options; we're basically re-implementing exec's options
+    // for use here with spawn under the hood
+    opts = /** @type {T} */ (lodash_1.default.defaults(opts, {
+        timeout: null,
+        encoding: 'utf8',
+        killSignal: 'SIGTERM',
+        cwd: undefined,
+        env: process.env,
+        ignoreOutput: false,
+        stdio: 'inherit',
+        isBuffer: false,
+        shell: undefined,
+        logger: undefined,
+        maxStdoutBufferSize: MAX_BUFFER_SIZE,
+        maxStderrBufferSize: MAX_BUFFER_SIZE,
+    }));
+    const isBuffer = Boolean(opts.isBuffer);
+    // this is an async function, so return a promise
+    return await new bluebird_1.default((resolve, reject) => {
+        // spawn the child process with options; we don't currently expose any of
+        // the other 'spawn' options through the API
+        let proc = (0, child_process_1.spawn)(cmd, args, { cwd: opts.cwd, env: opts.env, shell: opts.shell });
+        let stdoutArr = [], stderrArr = [], timer = null;
+        // if the process errors out, reject the promise
+        proc.on('error', /** @param {NodeJS.ErrnoException} err */ async (err) => {
+            if (err.code === 'ENOENT') {
+                err = await (0, helpers_1.formatEnoent)(err, cmd, opts.cwd?.toString());
+            }
+            reject(err);
+        });
+        if (proc.stdin) {
+            proc.stdin.on('error', /** @param {NodeJS.ErrnoException} err */ (err) => {
+                reject(new Error(`Standard input '${err.syscall}' error: ${err.stack}`));
+            });
+        }
+        const handleStream = (streamType, streamProps) => {
+            if (!proc[streamType]) {
+                return;
+            }
+            proc[streamType].on('error', (err) => {
+                reject(new Error(`${lodash_1.default.capitalize(streamType)} '${err.syscall}' error: ${err.stack}`));
+            });
+            if (opts.ignoreOutput) {
+                // https://github.com/nodejs/node/issues/4236
+                proc[streamType].on('data', () => { });
+                return;
+            }
+            // keep track of the stream if we don't want to ignore it
+            const { chunks, maxSize } = streamProps;
+            let size = 0;
+            proc[streamType].on('data', (chunk) => {
+                chunks.push(chunk);
+                size += chunk.length;
+                while (chunks.length > 1 && size >= maxSize) {
+                    size -= chunks[0].length;
+                    chunks.shift();
+                }
+                if (opts.logger && lodash_1.default.isFunction(opts.logger.debug)) {
+                    opts.logger.debug(chunk.toString());
+                }
+            });
+        };
+        handleStream('stdout', {
+            maxSize: opts.maxStdoutBufferSize,
+            chunks: stdoutArr,
+        });
+        handleStream('stderr', {
+            maxSize: opts.maxStderrBufferSize,
+            chunks: stderrArr,
+        });
+        /**
+         * @template {boolean} U
+         * @param {U} isBuffer
+         * @returns {U extends true ? {stdout: Buffer, stderr: Buffer} : {stdout: string, stderr: string}}
+         */
+        function getStdio(isBuffer) {
+            let stdout, stderr;
+            if (isBuffer) {
+                stdout = Buffer.concat(stdoutArr);
+                stderr = Buffer.concat(stderrArr);
+            }
+            else {
+                stdout = Buffer.concat(stdoutArr).toString(opts.encoding);
+                stderr = Buffer.concat(stderrArr).toString(opts.encoding);
+            }
+            return /** @type {U extends true ? {stdout: Buffer, stderr: Buffer} : {stdout: string, stderr: string}} */ ({ stdout, stderr });
+        }
+        // if the process ends, either resolve or reject the promise based on the
+        // exit code of the process. either way, attach stdout, stderr, and code.
+        // Also clean up the timer if it exists
+        proc.on('close', (code) => {
+            if (timer) {
+                clearTimeout(timer);
+            }
+            let { stdout, stderr } = getStdio(isBuffer);
+            if (code === 0) {
+                resolve(/** @type {BufferProp<T> extends true ? TeenProcessExecBufferResult : TeenProcessExecStringResult} */ ({ stdout, stderr, code }));
+            }
+            else {
+                let err = new Error(`Command '${rep}' exited with code ${code}`);
+                err = Object.assign(err, { stdout, stderr, code });
+                reject(err);
+            }
+        });
+        // if we set a timeout on the child process, cut into the execution and
+        // reject if the timeout is reached. Attach the stdout/stderr we currently
+        // have in case it's helpful in debugging
+        if (opts.timeout) {
+            timer = setTimeout(() => {
+                let { stdout, stderr } = getStdio(isBuffer);
+                let err = new Error(`Command '${rep}' timed out after ${opts.timeout}ms`);
+                err = Object.assign(err, { stdout, stderr, code: null });
+                reject(err);
+                // reject and THEN kill to avoid race conditions with the handlers
+                // above
+                proc.kill(opts.killSignal);
+            }, opts.timeout);
+        }
+    });
+}
+exports.exec = exec;
+exports.default = exec;
+/**
+ * Options on top of `SpawnOptions`, unique to `teen_process.`
+ * @typedef {Object} TeenProcessProps
+ * @property {boolean} [ignoreOutput] - Ignore & discard all output
+ * @property {boolean} [isBuffer] - Return output as a Buffer
+ * @property {TeenProcessLogger} [logger] - Logger to use for debugging
+ * @property {number} [maxStdoutBufferSize] - Maximum size of `stdout` buffer
+ * @property {number} [maxStderrBufferSize] - Maximum size of `stderr` buffer
+ * @property {BufferEncoding} [encoding='utf8'] - Encoding to use for output
+ */
+/**
+ * A logger object understood by {@link exec teen_process.exec}.
+ * @typedef {Object} TeenProcessLogger
+ * @property {(...args: any[]) => void} debug
+ */
+/**
+ * Options for {@link exec teen_process.exec}.
+ * @typedef {import('child_process').SpawnOptions & TeenProcessProps} TeenProcessExecOptions
+ */
+/**
+ * The value {@link exec teen_process.exec} resolves to when `isBuffer` is `false`
+ * @typedef {Object} TeenProcessExecStringResult
+ * @property {string} stdout - Stdout
+ * @property {string} stderr - Stderr
+ * @property {number?} code - Exit code
+ */
+/**
+ * The value {@link exec teen_process.exec} resolves to when `isBuffer` is `true`
+ * @typedef {Object} TeenProcessExecBufferResult
+ * @property {Buffer} stdout - Stdout
+ * @property {Buffer} stderr - Stderr
+ * @property {number?} code - Exit code
+ */
+/**
+ * Extra props {@link exec teen_process.exec} adds to its error objects
+ * @typedef {Object} TeenProcessExecErrorProps
+ * @property {string} stdout - STDOUT
+ * @property {string} stderr - STDERR
+ * @property {number?} code - Exit code
+ */
+/**
+ * Error thrown by {@link exec teen_process.exec}
+ * @typedef {Error & TeenProcessExecErrorProps} TeenProcessExecError
+ */
+/**
+ * @template {{isBuffer?: boolean}} MaybeBuffer
+ * @typedef {MaybeBuffer['isBuffer']} BufferProp
+ * @private
+ */
+//# sourceMappingURL=exec.js.map

package/build/lib/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../lib/exec.js"],"names":[],"mappings":"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"}

package/build/lib/helpers.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Decorates ENOENT error received from a spawn system call
+ * with a more descriptive message, so it could be properly handled by a user.
+ *
+ * @param {NodeJS.ErrnoException} error Original error instance. !!! The instance is mutated after
+ * this helper function invocation
+ * @param {string} cmd Original command to execute
+ * @param {string?} [cwd] Optional path to the current working dir
+ * @returns {Promise<NodeJS.ErrnoException>} Mutated error instance with an improved description or an
+ * unchanged error instance
+ */
+export function formatEnoent(error: NodeJS.ErrnoException, cmd: string, cwd?: string | null | undefined): Promise<NodeJS.ErrnoException>;
+//# sourceMappingURL=helpers.d.ts.map

package/build/lib/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../lib/helpers.js"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,oCAPW,OAAO,cAAc,OAErB,MAAM,oCAEJ,QAAQ,OAAO,cAAc,CAAC,CAwB1C"}

package/build/lib/helpers.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatEnoent = void 0;
+const path_1 = __importDefault(require("path"));
+const promises_1 = __importDefault(require("fs/promises"));
+/**
+ * Decorates ENOENT error received from a spawn system call
+ * with a more descriptive message, so it could be properly handled by a user.
+ *
+ * @param {NodeJS.ErrnoException} error Original error instance. !!! The instance is mutated after
+ * this helper function invocation
+ * @param {string} cmd Original command to execute
+ * @param {string?} [cwd] Optional path to the current working dir
+ * @returns {Promise<NodeJS.ErrnoException>} Mutated error instance with an improved description or an
+ * unchanged error instance
+ */
+async function formatEnoent(error, cmd, cwd = null) {
+    if (cwd) {
+        try {
+            const stat = await promises_1.default.stat(cwd);
+            if (!stat.isDirectory()) {
+                error.message = `The working directory '${cwd}' of '${cmd}' is not a valid folder path`;
+                return error;
+            }
+        }
+        catch (e) {
+            if (e.code === 'ENOENT') {
+                error.message = `The working directory '${cwd}' of '${cmd}' does not exist`;
+                return error;
+            }
+        }
+    }
+    const curDir = path_1.default.resolve(cwd ?? process.cwd());
+    const pathMsg = process.env.PATH ?? 'which is not defined for the process';
+    error.message = `'${cmd}' executable is not found neither in the process working folder (${curDir}) ` +
+        `nor in any folders specified in the PATH environment variable (${pathMsg})`;
+    return error;
+}
+exports.formatEnoent = formatEnoent;
+//# sourceMappingURL=helpers.js.map

package/build/lib/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../lib/helpers.js"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AACxB,2DAA6B;AAE7B;;;;;;;;;;GAUG;AACH,KAAK,UAAU,YAAY,CAAE,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI;IACjD,IAAI,GAAG,EAAE;QACP,IAAI;YACF,MAAM,IAAI,GAAG,MAAM,kBAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE;gBACvB,KAAK,CAAC,OAAO,GAAG,0BAA0B,GAAG,SAAS,GAAG,8BAA8B,CAAC;gBACxF,OAAO,KAAK,CAAC;aACd;SACF;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE;gBACvB,KAAK,CAAC,OAAO,GAAG,0BAA0B,GAAG,SAAS,GAAG,kBAAkB,CAAC;gBAC5E,OAAO,KAAK,CAAC;aACd;SACF;KACF;IAED,MAAM,MAAM,GAAG,cAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,sCAAsC,CAAC;IAC3E,KAAK,CAAC,OAAO,GAAG,IAAI,GAAG,oEAAoE,MAAM,IAAI;QACnG,kEAAkE,OAAO,GAAG,CAAC;IAC/E,OAAO,KAAK,CAAC;AACf,CAAC;AAEQ,oCAAY"}

package/build/lib/index.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="node" />
+export const exec: typeof execIndex.exec;
+export const spawn: typeof cp.spawn;
+export const SubProcess: typeof spIndex.SubProcess;
+import * as execIndex from './exec';
+import * as cp from 'child_process';
+import * as spIndex from './subprocess';
+//# sourceMappingURL=index.d.ts.map

package/build/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/index.js"],"names":[],"mappings":";;;;2BAK2B,QAAQ;oBAFf,eAAe;yBACV,cAAc"}

package/build/lib/index.js

@@ -0,0 +1,38 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubProcess = exports.spawn = exports.exec = void 0;
+const source_map_support_1 = require("source-map-support");
+(0, source_map_support_1.install)();
+const cp = __importStar(require("child_process"));
+const spIndex = __importStar(require("./subprocess"));
+const execIndex = __importStar(require("./exec"));
+const { spawn } = cp;
+exports.spawn = spawn;
+const { SubProcess } = spIndex;
+exports.SubProcess = SubProcess;
+const { exec } = execIndex;
+exports.exec = exec;
+//# sourceMappingURL=index.js.map

package/build/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2DAA2C;AAC3C,IAAA,4BAAO,GAAE,CAAC;AAEV,kDAAoC;AACpC,sDAAwC;AACxC,kDAAoC;AAEpC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAIN,sBAAK;AAHpB,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;AAGT,gCAAU;AAFhC,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC;AAElB,oBAAI"}

package/build/lib/subprocess.d.ts

@@ -0,0 +1,66 @@
+/// <reference types="node" />
+export default SubProcess;
+export type StartDetector = (stdout: string, stderr?: string | undefined) => any;
+export class SubProcess extends events {
+    /**
+     * @param {string} cmd
+     * @param {string[]} [args]
+     * @param {any} [opts]
+     */
+    constructor(cmd: string, args?: string[] | undefined, opts?: any);
+    /**
+     * @type { {stdout: string, stderr: string} }
+     */
+    lastLinePortion: {
+        stdout: string;
+        stderr: string;
+    };
+    /** @type {import('child_process').ChildProcess?} */
+    proc: import('child_process').ChildProcess | null;
+    /** @type {string[]} */
+    args: string[];
+    /**
+     * @type {string}
+     */
+    cmd: string;
+    /**
+     * @type {any}
+    */
+    opts: any;
+    /**
+     * @type {boolean}
+     */
+    expectingExit: boolean;
+    /**
+     * @type {string}
+     */
+    rep: string;
+    get isRunning(): boolean;
+    /**
+     *
+     * @param {string} stream
+     * @param {Iterable<string>} lines
+     */
+    emitLines(stream: string, lines: Iterable<string>): void;
+    /**
+     *
+     * @param {StartDetector|number?} startDetector
+     * @param {number?} timeoutMs
+     * @param {boolean} detach
+     * @returns {Promise<void>}
+     */
+    start(startDetector?: StartDetector | (number | null), timeoutMs?: number | null, detach?: boolean): Promise<void>;
+    handleLastLines(): void;
+    /**
+     *
+     * @param {NodeJS.Signals} signal
+     * @param {number} timeout
+     * @returns {Promise<void>}
+     */
+    stop(signal?: NodeJS.Signals, timeout?: number): Promise<void>;
+    join(allowedExitCodes?: number[]): Promise<any>;
+    detachProcess(): void;
+    get pid(): number | null | undefined;
+}
+import events from 'events';
+//# sourceMappingURL=subprocess.d.ts.map

package/build/lib/subprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.d.ts","sourceRoot":"","sources":["../../lib/subprocess.js"],"names":[],"mappings":";;qCAsVW,MAAM,kCAEJ,GAAG;AAhUhB;IAiCE;;;;OAIG;IACH,iBAJW,MAAM,sCAEN,GAAG,EAkBb;IApDD;;OAEG;IACH,iBAFW;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAE3B;IAEhB,oDAAoD;IACpD,MADW,OAAO,eAAe,EAAE,YAAY,QAC1C;IAEL,uBAAuB;IACvB,MADW,MAAM,EAAE,CACd;IAEL;;OAEG;IACH,KAFU,MAAM,CAEZ;IAEJ;;MAEE;IACF,MAFU,GAAG,CAER;IAEL;;OAEG;IACH,eAFU,OAAO,CAEH;IAEd;;OAEG;IACH,KAFU,MAAM,CAEZ;IAyBJ,yBAGC;IAED;;;;OAIG;IACH,kBAHW,MAAM,SACN,SAAS,MAAM,CAAC,QAM1B;IAID;;;;;;OAMG;IACH,sBALW,aAAa,IAAC,MAAM,QAAC,cACrB,MAAM,kBACN,OAAO,GACL,QAAQ,IAAI,CAAC,CAkKzB;IAED,wBASC;IAED;;;;;OAKG;IACH,cAJW,OAAO,OAAO,YACd,MAAM,GACJ,QAAQ,IAAI,CAAC,CAmBzB;IAED,gDAcC;IAKD,sBAQC;IAED,qCAEC;CACF;mBA5UkB,QAAQ"}

package/build/lib/subprocess.js

@@ -0,0 +1,290 @@
+"use strict";
+/* eslint-disable promise/prefer-await-to-callbacks */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubProcess = void 0;
+const child_process_1 = require("child_process");
+const events_1 = __importDefault(require("events"));
+const { EventEmitter } = events_1.default;
+const bluebird_1 = __importDefault(require("bluebird"));
+const shell_quote_1 = require("shell-quote");
+const lodash_1 = __importDefault(require("lodash"));
+const helpers_1 = require("./helpers");
+// This is needed to avoid memory leaks
+// when the process output is too long and contains
+// no line breaks
+const MAX_LINE_PORTION_LENGTH = 0xFFFF;
+function cutSuffix(str, suffixLength) {
+    return str.length > suffixLength
+        // https://bugs.chromium.org/p/v8/issues/detail?id=2869
+        ? ` ${str.substr(str.length - suffixLength)}`.substr(1)
+        : str;
+}
+class SubProcess extends EventEmitter {
+    /**
+     * @param {string} cmd
+     * @param {string[]} [args]
+     * @param {any} [opts]
+     */
+    constructor(cmd, args = [], opts = {}) {
+        super();
+        if (!cmd)
+            throw new Error('Command is required'); // eslint-disable-line curly
+        if (!lodash_1.default.isString(cmd))
+            throw new Error('Command must be a string'); // eslint-disable-line curly
+        if (!lodash_1.default.isArray(args))
+            throw new Error('Args must be an array'); // eslint-disable-line curly
+        this.cmd = cmd;
+        this.args = args;
+        this.proc = null;
+        this.opts = opts;
+        this.expectingExit = false;
+        // get a quoted representation of the command for error strings
+        this.rep = (0, shell_quote_1.quote)([cmd, ...args]);
+        this.lastLinePortion = { stdout: '', stderr: '' };
+    }
+    get isRunning() {
+        // presence of `proc` means we have connected and started
+        return !!this.proc;
+    }
+    /**
+     *
+     * @param {string} stream
+     * @param {Iterable<string>} lines
+     */
+    emitLines(stream, lines) {
+        for (let line of lines) {
+            this.emit('stream-line', `[${stream.toUpperCase()}] ${line}`);
+        }
+    }
+    // spawn the subprocess and return control whenever we deem that it has fully
+    // "started"
+    /**
+     *
+     * @param {StartDetector|number?} startDetector
+     * @param {number?} timeoutMs
+     * @param {boolean} detach
+     * @returns {Promise<void>}
+     */
+    async start(startDetector = null, timeoutMs = null, detach = false) {
+        let startDelay = 10;
+        const genericStartDetector = /** @type {StartDetector} */ (function genericStartDetector(stdout, stderr) {
+            return stdout || stderr;
+        });
+        // the default start detector simply returns true when we get any output
+        if (startDetector === null) {
+            startDetector = genericStartDetector;
+        }
+        // if the user passes a number, then we simply delay a certain amount of
+        // time before returning control, rather than waiting for a condition
+        if (lodash_1.default.isNumber(startDetector)) {
+            startDelay = startDetector;
+            startDetector = null;
+        }
+        // if the user passes in a boolean as one of the arguments, use it for `detach`
+        if (lodash_1.default.isBoolean(startDetector) && startDetector) {
+            if (!this.opts.detached) {
+                throw new Error(`Unable to detach process that is not started with 'detached' option`);
+            }
+            detach = true;
+            startDetector = genericStartDetector;
+        }
+        else if (lodash_1.default.isBoolean(timeoutMs) && timeoutMs) {
+            if (!this.opts.detached) {
+                throw new Error(`Unable to detach process that is not started with 'detached' option`);
+            }
+            detach = true;
+            timeoutMs = null;
+        }
+        // return a promise so we can wrap the async behavior
+        return await new bluebird_1.default((resolve, reject) => {
+            // actually spawn the subproc
+            this.proc = (0, child_process_1.spawn)(this.cmd, this.args, this.opts);
+            if (this.proc.stdout) {
+                this.proc.stdout.setEncoding(this.opts.encoding || 'utf8');
+            }
+            if (this.proc.stderr) {
+                this.proc.stderr.setEncoding(this.opts.encoding || 'utf8');
+            }
+            this.lastLinePortion = { stdout: '', stderr: '' };
+            // this function handles output that we collect from the subproc
+            /**
+             *
+             * @param { {stdout: string, stderr: string} } streams
+             */
+            const handleOutput = (streams) => {
+                const { stdout, stderr } = streams;
+                // if we have a startDetector, run it on the output so we can resolve/
+                // reject and move on from start
+                try {
+                    if (lodash_1.default.isFunction(startDetector) && startDetector(stdout, stderr)) {
+                        startDetector = null;
+                        resolve();
+                    }
+                }
+                catch (e) {
+                    reject(e);
+                }
+                // emit the actual output for whomever's listening
+                this.emit('output', stdout, stderr);
+                // we also want to emit lines, but it's more complex since output
+                // comes in chunks and a line could come in two different chunks, so
+                // we have logic to handle that case (using this.lastLinePortion to
+                // remember a line that started but did not finish in the last chunk)
+                for (const [streamName, streamData] of /** @type {[['stdout', string], ['stderr', string]]} */ (lodash_1.default.toPairs(streams))) {
+                    if (!streamData)
+                        continue; // eslint-disable-line curly
+                    const lines = streamData.split('\n')
+                        // https://bugs.chromium.org/p/v8/issues/detail?id=2869
+                        .map((x) => ` ${x}`.substr(1));
+                    if (lines.length > 1) {
+                        lines[0] = this.lastLinePortion[streamName] + lines[0];
+                        this.lastLinePortion[streamName] = cutSuffix(lodash_1.default.last(lines), MAX_LINE_PORTION_LENGTH);
+                        const resultLines = lines.slice(0, -1);
+                        this.emit(`lines-${streamName}`, resultLines);
+                        this.emitLines(streamName, resultLines);
+                    }
+                    else {
+                        const currentPortion = cutSuffix(lines[0], MAX_LINE_PORTION_LENGTH);
+                        if (this.lastLinePortion[streamName].length + currentPortion.length > MAX_LINE_PORTION_LENGTH) {
+                            this.lastLinePortion[streamName] = currentPortion;
+                        }
+                        else {
+                            this.lastLinePortion[streamName] += currentPortion;
+                        }
+                    }
+                }
+            };
+            // if we get an error spawning the proc, reject and clean up the proc
+            this.proc.on('error', /** @param {NodeJS.ErrnoException} err */ async (err) => {
+                this.proc?.removeAllListeners('exit');
+                this.proc?.kill('SIGINT');
+                if (err.code === 'ENOENT') {
+                    err = await (0, helpers_1.formatEnoent)(err, this.cmd, this.opts?.cwd);
+                }
+                reject(err);
+                this.proc?.unref();
+                this.proc = null;
+            });
+            if (this.proc.stdout) {
+                this.proc.stdout.on('data', (chunk) => handleOutput({ stdout: chunk.toString(), stderr: '' }));
+            }
+            if (this.proc.stderr) {
+                this.proc.stderr.on('data', (chunk) => handleOutput({ stdout: '', stderr: chunk.toString() }));
+            }
+            // when the proc exits, we might still have a buffer of lines we were
+            // waiting on more chunks to complete. Go ahead and emit those, then
+            // re-emit the exit so a listener can handle the possibly-unexpected exit
+            this.proc.on('exit', (code, signal) => {
+                this.handleLastLines();
+                this.emit('exit', code, signal);
+                // in addition to the bare exit event, also emit one of three other
+                // events that contain more helpful information:
+                // 'stop': we stopped this
+                // 'die': the process ended out of our control with a non-zero exit
+                // 'end': the process ended out of our control with a zero exit
+                let event = this.expectingExit ? 'stop' : 'die';
+                if (!this.expectingExit && code === 0) {
+                    event = 'end';
+                }
+                this.emit(event, code, signal);
+                // finally clean up the proc and make sure to reset our exit
+                // expectations
+                this.proc = null;
+                this.expectingExit = false;
+            });
+            // if the user hasn't given us a startDetector, instead just resolve
+            // when startDelay ms have passed
+            if (!startDetector) {
+                setTimeout(() => { resolve(); }, startDelay);
+            }
+            // if the user has given us a timeout, start the clock for rejecting
+            // the promise if we take too long to start
+            if (lodash_1.default.isNumber(timeoutMs)) {
+                setTimeout(() => {
+                    reject(new Error(`The process did not start within ${timeoutMs}ms ` +
+                        `(cmd: '${this.rep}')`));
+                }, timeoutMs);
+            }
+        }).finally(() => {
+            if (detach && this.proc) {
+                this.proc.unref();
+            }
+        });
+    }
+    handleLastLines() {
+        for (let stream of ['stdout', 'stderr']) {
+            if (this.lastLinePortion[stream]) {
+                const lastLines = [this.lastLinePortion[stream]];
+                this.emit(`lines-${stream}`, lastLines);
+                this.emitLines(stream, lastLines);
+                this.lastLinePortion[stream] = '';
+            }
+        }
+    }
+    /**
+     *
+     * @param {NodeJS.Signals} signal
+     * @param {number} timeout
+     * @returns {Promise<void>}
+     */
+    async stop(signal = 'SIGTERM', timeout = 10000) {
+        if (!this.isRunning) {
+            throw new Error(`Can't stop process; it's not currently running (cmd: '${this.rep}')`);
+        }
+        // make sure to emit any data in our lines buffer whenever we're done with
+        // the proc
+        this.handleLastLines();
+        return await new bluebird_1.default((resolve, reject) => {
+            this.proc?.on('close', resolve);
+            this.expectingExit = true;
+            this.proc?.kill(signal);
+            // this timeout needs unref() or node will wait for the timeout to fire before
+            // exiting the process.
+            setTimeout(() => {
+                reject(new Error(`Process didn't end after ${timeout}ms (cmd: '${this.rep}')`));
+            }, timeout).unref();
+        });
+    }
+    async join(allowedExitCodes = [0]) {
+        if (!this.isRunning) {
+            throw new Error(`Cannot join process; it is not currently running (cmd: '${this.rep}')`);
+        }
+        return await new bluebird_1.default((resolve, reject) => {
+            this.proc?.on('exit', (code) => {
+                if (code !== null && allowedExitCodes.indexOf(code) === -1) {
+                    reject(new Error(`Process ended with exitcode ${code} (cmd: '${this.rep}')`));
+                }
+                else {
+                    resolve(code);
+                }
+            });
+        });
+    }
+    /*
+     * This will only work if the process is created with the `detached` option
+     */
+    detachProcess() {
+        if (!this.opts.detached) {
+            // this means that there is a misconfiguration in the calling code
+            throw new Error(`Unable to detach process that is not started with 'detached' option`);
+        }
+        if (this.proc) {
+            this.proc.unref();
+        }
+    }
+    get pid() {
+        return this.proc ? this.proc.pid : null;
+    }
+}
+exports.SubProcess = SubProcess;
+exports.default = SubProcess;
+/**
+ * @callback StartDetector
+ * @param {string} stdout
+ * @param {string} [stderr]
+ * @returns {any}
+ */
+//# sourceMappingURL=subprocess.js.map

package/build/lib/subprocess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.js","sourceRoot":"","sources":["../../lib/subprocess.js"],"names":[],"mappings":"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"}

package/index.js

@@ -1,12 +1 @@
-import {install} from 'source-map-support';
-install();
-
-import * as cp from 'child_process';
-import * as spIndex from './lib/subprocess';
-import * as execIndex from './lib/exec';
-
-const { spawn } = cp;
-const { SubProcess } = spIndex;
-const { exec } = execIndex;
-
-export { exec, spawn, SubProcess };
+module.exports = require('./build/lib');

package/lib/index.js

@@ -0,0 +1,12 @@
+import {install} from 'source-map-support';
+install();
+
+import * as cp from 'child_process';
+import * as spIndex from './subprocess';
+import * as execIndex from './exec';
+
+const { spawn } = cp;
+const { SubProcess } = spIndex;
+const { exec } = execIndex;
+
+export { exec, spawn, SubProcess };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teen_process",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "A grown up version of Node's spawn/exec",
   "keywords": [
     "child_process",
@@ -64,32 +64,36 @@
     "source-map-support": "0.5.21"
   },
   "devDependencies": {
-    "@appium/eslint-config-appium": "8.0.3",
-    "@appium/tsconfig": "0.3.0",
-    "@appium/types": "0.11.1",
+    "@appium/eslint-config-appium": "8.0.4",
+    "@appium/tsconfig": "0.3.1",
+    "@appium/types": "0.13.4",
+    "@semantic-release/changelog": "^6.0.1",
+    "@semantic-release/git": "^10.0.1",
     "@types/bluebird": "3.5.38",
     "@types/chai": "4.3.5",
     "@types/chai-as-promised": "7.1.5",
-    "@types/lodash": "4.14.195",
+    "@types/lodash": "4.14.197",
     "@types/mocha": "10.0.1",
-    "@types/node": "18.16.17",
+    "@types/node": "18.17.11",
     "@types/shell-quote": "1.7.1",
-    "@types/sinon": "10.0.15",
-    "@types/source-map-support": "0.5.6",
-    "@types/ws": "8.5.4",
+    "@types/sinon": "10.0.16",
+    "@types/source-map-support": "0.5.7",
+    "@types/ws": "8.5.5",
     "chai": "4.3.7",
     "chai-as-promised": "7.1.1",
-    "eslint": "8.42.0",
-    "eslint-config-prettier": "8.8.0",
-    "eslint-plugin-import": "2.27.5",
+    "conventional-changelog-conventionalcommits": "^6.1.0",
+    "eslint": "8.47.0",
+    "eslint-config-prettier": "8.10.0",
+    "eslint-plugin-import": "2.28.1",
     "eslint-plugin-mocha": "10.1.0",
     "eslint-plugin-promise": "6.1.1",
-    "lint-staged": "13.2.2",
+    "lint-staged": "13.3.0",
     "mocha": "10.2.0",
     "pre-commit": "1.2.2",
-    "prettier": "2.8.8",
-    "sinon": "15.1.2",
-    "typescript": "5.1.3",
+    "prettier": "3.0.2",
+    "semantic-release": "^21.1.0",
+    "sinon": "15.2.0",
+    "typescript": "5.1.6",
     "ts-node": "10.9.1"
   },
   "engines": {