promisify-child-process 4.1.1 → 5.0.0

package/index.js

@@ -0,0 +1,141 @@
+import child_process from 'child_process';
+function joinChunks(chunks, encoding) {
+  if (!chunks) return undefined;
+  const buffer = Buffer.concat(chunks);
+  return encoding && encoding !== 'buffer' ? buffer.toString(encoding) : buffer;
+}
+export function promisifyChildProcess(child, options) {
+  var _promise$finally;
+  const promise = new Promise((resolve, reject) => {
+    var _child$stdout, _child$stderr;
+    const encoding = options === null || options === void 0 ? void 0 : options.encoding;
+    const killSignal = options === null || options === void 0 ? void 0 : options.killSignal;
+    const captureStdio = encoding != null || (options === null || options === void 0 ? void 0 : options.maxBuffer) != null;
+    const maxBuffer = (options === null || options === void 0 ? void 0 : options.maxBuffer) ?? 1024 * 1024;
+    let bufferSize = 0;
+    let error;
+    const stdoutChunks = captureStdio && child.stdout ? [] : undefined;
+    const stderrChunks = captureStdio && child.stderr ? [] : undefined;
+    const capture = chunks => data => {
+      if (typeof data === 'string') data = Buffer.from(data);
+      const remaining = Math.max(0, maxBuffer - bufferSize);
+      bufferSize += Math.min(remaining, data.length);
+      if (data.length > remaining) {
+        error = new Error('maxBuffer exceeded');
+        child.kill(killSignal ?? 'SIGTERM');
+        data = data.subarray(0, remaining);
+      }
+      chunks.push(data);
+    };
+    const captureStdout = stdoutChunks ? capture(stdoutChunks) : undefined;
+    const captureStderr = stderrChunks ? capture(stderrChunks) : undefined;
+    if (captureStdout) (_child$stdout = child.stdout) === null || _child$stdout === void 0 || _child$stdout.on('data', captureStdout);
+    if (captureStderr) (_child$stderr = child.stderr) === null || _child$stderr === void 0 || _child$stderr.on('data', captureStderr);
+    function onError(err) {
+      error = err;
+      done();
+    }
+    child.on('error', onError);
+    function done(code = null, signal = null) {
+      var _child$stdout2, _child$stderr2;
+      child.removeListener('error', onError);
+      child.removeListener('close', done);
+      if (captureStdout) (_child$stdout2 = child.stdout) === null || _child$stdout2 === void 0 || _child$stdout2.removeListener('data', captureStdout);
+      if (captureStderr) (_child$stderr2 = child.stderr) === null || _child$stderr2 === void 0 || _child$stderr2.removeListener('data', captureStderr);
+      const stdout = joinChunks(stdoutChunks, encoding);
+      const stderr = joinChunks(stderrChunks, encoding);
+      if (error || code != null && code != 0 || signal != null) {
+        reject(Object.assign(error || new Error(signal != null ? `Process was killed with ${signal}` : `Process exited with code ${code}`), {
+          code,
+          signal,
+          killed: signal != null,
+          stdout,
+          stderr
+        }));
+      } else {
+        resolve({
+          stderr,
+          stdout,
+          code,
+          signal,
+          killed: false
+        });
+      }
+    }
+    child.on('close', done);
+  });
+  return Object.create(child, {
+    then: {
+      value: promise.then.bind(promise)
+    },
+    catch: {
+      value: promise.catch.bind(promise)
+    },
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    finally: {
+      value: (_promise$finally = promise.finally) === null || _promise$finally === void 0 ? void 0 : _promise$finally.bind(promise)
+    }
+  });
+}
+function isArray(t) {
+  return Array.isArray(t);
+}
+export function spawn(command, args, options) {
+  if (!isArray(args)) {
+    options = args;
+    args = [];
+  }
+  return promisifyChildProcess(child_process.spawn(command, args, options), options);
+}
+export function fork(module, args, options) {
+  if (!isArray(args)) {
+    options = args;
+    args = [];
+  }
+  return promisifyChildProcess(child_process.fork(module, args, options), options);
+}
+function promisifyExecMethod(method) {
+  return (...args) => {
+    var _promise$finally2;
+    let child;
+    const promise = new Promise((resolve, reject) => {
+      child = method(...args, (err, stdout, stderr) => {
+        if (err) {
+          reject(Object.assign(err, {
+            stdout,
+            stderr
+          }));
+        } else {
+          resolve({
+            code: 0,
+            signal: null,
+            killed: false,
+            stdout: stdout,
+            stderr: stderr
+          });
+        }
+      });
+    });
+    if (!child) {
+      throw new Error('unexpected error: child has not been initialized');
+    }
+    return Object.create(child, {
+      then: {
+        value: promise.then.bind(promise)
+      },
+      catch: {
+        value: promise.catch.bind(promise)
+      },
+      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+      finally: {
+        value: (_promise$finally2 = promise.finally) === null || _promise$finally2 === void 0 ? void 0 : _promise$finally2.bind(promise)
+      }
+    });
+  };
+}
+export const exec = promisifyExecMethod(child_process.exec);
+export const execFile = promisifyExecMethod(child_process.execFile);
+export function isChildProcessError(error) {
+  return error instanceof Error && 'code' in error && 'signal' in error;
+}
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["child_process","joinChunks","chunks","encoding","undefined","buffer","Buffer","concat","toString","promisifyChildProcess","child","options","_promise$finally","promise","Promise","resolve","reject","_child$stdout","_child$stderr","killSignal","captureStdio","maxBuffer","bufferSize","error","stdoutChunks","stdout","stderrChunks","stderr","capture","data","from","remaining","Math","max","min","length","Error","kill","subarray","push","captureStdout","captureStderr","on","onError","err","done","code","signal","_child$stdout2","_child$stderr2","removeListener","Object","assign","killed","create","then","value","bind","catch","finally","isArray","t","Array","spawn","command","args","fork","module","promisifyExecMethod","method","_promise$finally2","exec","execFile","isChildProcessError"],"sources":["src/index.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/package.json

@@ -1,79 +1,13 @@
 {
   "name": "promisify-child-process",
-  "version": "4.1.1",
+  "version": "5.0.0",
   "description": "seriously like the best async child process library",
   "engines": {
-    "node": ">=8"
+    "node": ">=16"
   },
-  "main": "./index.cjs",
-  "exports": {
-    "import": "./index.mjs",
-    "require": "./index.cjs"
-  },
-  "files": [
-    "index.cjs",
-    "index.mjs",
-    "index.d.ts",
-    "index.js.flow"
-  ],
+  "types": "index.d.cts",
+  "type": "module",
   "sideEffects": false,
-  "scripts": {
-    "lint": "eslint src test --cache",
-    "lint:fix": "eslint --fix src test --cache",
-    "lint:watch": "esw --watch src test --cache",
-    "prettier": "prettier --write *.json *.md *.js *.ts '{src,test}/**/*.js'",
-    "prettier:check": "prettier --list-different *.json *.md *.js *.ts '{src,test}/**/*.js'",
-    "flow": "flow",
-    "flow:coverage": "for file in src/**.js test/**.js; do echo $file; flow coverage $file; done",
-    "flow:watch": "flow-watch -e js,js.flow,flowconfig --ignore es/ --ignore node_modules/ --watch .flowconfig --watch src/ --watch test/",
-    "build": "babel src/index.js -o index.cjs && flow-copy-source -v src/ .",
-    "test": "cross-env NODE_ENV=test mocha $npm_package_config_mocha && cross-env NODE_ENV=test BABEL_ENV=coverage nyc --reporter=lcov --reporter=text mocha $npm_package_config_mocha",
-    "test:watch": "cross-env NODE_ENV=test BABEL_ENV=test mocha --watch $npm_package_config_mocha",
-    "test:debug": "cross-env NODE_ENV=test BABEL_ENV=test mocha --inspect-brk $npm_package_config_mocha",
-    "codecov": "nyc report --reporter=text-lcov > coverage.lcov; codecov",
-    "prepublishOnly": "npm run prettier:check && npm run lint && flow && tsc && npm test && npm run build",
-    "open:coverage": "open coverage/lcov-report/index.html",
-    "semantic-release": "semantic-release"
-  },
-  "husky": {
-    "hooks": {
-      "pre-commit": "lint-staged && npm run lint && flow && tsc",
-      "commit-msg": "commitlint -e $GIT_PARAMS",
-      "pre-push": "npm test"
-    }
-  },
-  "lint-staged": {
-    "*.{js,json,css,md,ts}": [
-      "prettier --write",
-      "git add"
-    ]
-  },
-  "commitlint": {
-    "extends": [
-      "@jedwards1211/commitlint-config"
-    ]
-  },
-  "prettier": {
-    "semi": false,
-    "singleQuote": true,
-    "trailingComma": "es5"
-  },
-  "config": {
-    "mocha": "-r @babel/register test/configure.js 'test/**/*.js'",
-    "commitizen": {
-      "path": "cz-conventional-changelog"
-    }
-  },
-  "nyc": {
-    "include": [
-      "src/**/*.js"
-    ],
-    "require": [
-      "@babel/register"
-    ],
-    "sourceMap": false,
-    "instrument": false
-  },
   "repository": {
     "type": "git",
     "url": "https://github.com/jcoreio/promisify-child-process.git"
@@ -98,62 +32,24 @@
     "url": "https://github.com/jcoreio/promisify-child-process/issues"
   },
   "homepage": "https://github.com/jcoreio/promisify-child-process#readme",
-  "devDependencies": {
-    "@babel/cli": "^7.1.5",
-    "@babel/core": "^7.1.6",
-    "@babel/plugin-proposal-object-rest-spread": "^7.0.0",
-    "@babel/preset-env": "^7.1.6",
-    "@babel/preset-flow": "^7.0.0",
-    "@babel/register": "^7.0.0",
-    "@commitlint/cli": "^7.0.0",
-    "@commitlint/config-conventional": "^7.0.0",
-    "@jedwards1211/commitlint-config": "^1.0.0",
-    "@jedwards1211/eslint-config": "^2.0.0",
-    "@jedwards1211/eslint-config-flow": "^2.0.0",
-    "@types/node": "^12.12.17",
-    "babel-eslint": "^10.0.1",
-    "babel-plugin-istanbul": "^5.1.0",
-    "chai": "^4.2.0",
-    "codecov": "^3.1.0",
-    "copy": "^0.3.2",
-    "cross-env": "^5.2.0",
-    "eslint": "^5.9.0",
-    "eslint-config-prettier": "^3.3.0",
-    "eslint-plugin-flowtype": "^3.2.0",
-    "eslint-watch": "^4.0.2",
-    "flow-bin": "^0.124.0",
-    "flow-copy-source": "^2.0.2",
-    "flow-watch": "^1.1.4",
-    "fs-extra": "^7.0.1",
-    "husky": "^1.1.4",
-    "istanbul": "^0.4.5",
-    "lint-staged": "^8.0.4",
-    "mocha": "^6.2.1",
-    "nyc": "^13.1.0",
-    "prettier": "^1.15.2",
-    "prettier-eslint": "^8.8.2",
-    "rimraf": "^2.6.0",
-    "semantic-release": "^15.13.31",
-    "typescript": "^3.7.3",
-    "waait": "^1.0.5"
-  },
-  "dependencies": {},
-  "renovate": {
-    "extends": [
-      ":separateMajorReleases",
-      ":combinePatchMinorReleases",
-      ":ignoreUnstable",
-      ":prImmediately",
-      ":renovatePrefix",
-      ":updateNotScheduled",
-      ":preserveSemverRanges",
-      ":semanticPrefixFixDepsChoreOthers",
-      ":automergeDisabled",
-      "group:monorepos"
-    ],
-    "automerge": true,
-    "major": {
-      "automerge": false
+  "main": "index.cjs",
+  "module": "index.js",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": {
+        "import": "./index.d.ts",
+        "default": "./index.d.cts"
+      },
+      "import": "./index.js",
+      "default": "./index.cjs"
     }
+  },
+  "packageManager": "pnpm@10.6.5",
+  "dependencies": {
+    "@babel/runtime": "^7.26.0"
+  },
+  "@jcoreio/toolchain": {
+    "migratedVersion": "5.8.8"
   }
 }

package/src/index.ts

@@ -0,0 +1,314 @@
+import { ChildProcess, StdioOptions } from 'child_process'
+import child_process from 'child_process'
+import { Pipe, Readable, Writable } from 'stream'
+
+interface IOOptions {
+  silent?: boolean
+  stdio?: StdioOptions
+  encoding?: BufferEncoding | 'buffer' | null
+  maxBuffer?: number
+}
+
+type ChunkTypeHelper<MaxBuffer, Encoding> =
+  MaxBuffer extends number ?
+    Encoding extends BufferEncoding ?
+      string
+    : Buffer
+  : Encoding extends BufferEncoding ? string
+  : Encoding extends 'buffer' ? Buffer
+  : undefined
+
+type ChunkType<Options extends IOOptions> = ChunkTypeHelper<
+  'maxBuffer' extends keyof Options ? Options['maxBuffer'] : undefined,
+  'encoding' extends keyof Options ? Options['encoding'] : undefined
+>
+
+type IsPipeHelper<Stdio, Silent, Fd extends 0 | 1 | 2> =
+  Stdio extends unknown[] ?
+    Stdio[Fd] extends infer Value ?
+      Value extends 'pipe' | 'overlapped' ?
+        true
+      : false
+    : false
+  : Stdio extends null | undefined | 'pipe' | 'overlapped' ? true
+  : Stdio extends null | undefined ?
+    Silent extends true ?
+      false
+    : true
+  : false
+
+type IsPipe<Options extends IOOptions, Fd extends 0 | 1 | 2> = IsPipeHelper<
+  'stdio' extends keyof Options ? Options['stdio'] : undefined,
+  'silent' extends keyof Options ? Options['silent'] : undefined,
+  Fd
+>
+
+type Contains<A, T> =
+  A extends [infer Head, ...infer Tail] ?
+    Head extends T ?
+      true
+    : Contains<Tail, T>
+  : false
+
+export interface ChildProcessResult<Options extends IOOptions> {
+  stdout: IsPipe<Options, 1> extends true ? ChunkType<Options> : undefined
+  stderr: IsPipe<Options, 2> extends true ? ChunkType<Options> : undefined
+  code: number | null
+  signal: string | null
+  killed: boolean
+}
+
+type StdioStreams<Stdio> = {
+  [K in keyof Stdio]: Stdio[K] extends 'pipe' | 'overlapped' ?
+    K extends 0 | '0' ?
+      Writable
+    : Readable
+  : null
+}
+
+export interface ChildProcessPromise<Options extends IOOptions>
+  extends ChildProcess, Promise<ChildProcessResult<Options>> {
+  stdin: IsPipe<Options, 0> extends true ? Writable : null
+  stdout: IsPipe<Options, 1> extends true ? Readable : null
+  stderr: IsPipe<Options, 2> extends true ? Readable : null
+  readonly channel: Options['stdio'] extends infer Stdio ?
+    Contains<Stdio, 'ipc'> extends true ?
+      Pipe
+    : undefined
+  : undefined
+  readonly stdio: Options['stdio'] extends infer Stdio ?
+    Stdio extends unknown[] ? StdioStreams<Stdio>
+    : Stdio extends null | undefined | 'pipe' | 'overlapped' ?
+      [Writable, Readable, Readable, undefined, undefined]
+    : [null, null, null, undefined, undefined]
+  : [null, null, null, undefined, undefined]
+}
+
+interface PromisifyChildProcessBaseOptions extends IOOptions {
+  killSignal?: NodeJS.Signals | number
+}
+
+function joinChunks(
+  chunks: Buffer[] | undefined,
+  encoding: BufferEncoding | 'buffer' | null | undefined
+): string | Buffer | undefined {
+  if (!chunks) return undefined
+  const buffer = Buffer.concat(chunks)
+  return encoding && encoding !== 'buffer' ? buffer.toString(encoding) : buffer
+}
+
+export function promisifyChildProcess<
+  Options extends PromisifyChildProcessBaseOptions,
+>(child: ChildProcess, options?: Options): ChildProcessPromise<Options> {
+  const promise = new Promise<ChildProcessResult<Options>>(
+    (resolve, reject) => {
+      const encoding = options?.encoding
+      const killSignal = options?.killSignal
+      const captureStdio = encoding != null || options?.maxBuffer != null
+      const maxBuffer = options?.maxBuffer ?? 1024 * 1024
+      let bufferSize = 0
+      let error: Error | undefined
+      const stdoutChunks: Buffer[] | undefined =
+        captureStdio && child.stdout ? [] : undefined
+      const stderrChunks: Buffer[] | undefined =
+        captureStdio && child.stderr ? [] : undefined
+      const capture = (chunks: Buffer[]) => (data: string | Buffer) => {
+        if (typeof data === 'string') data = Buffer.from(data)
+        const remaining = Math.max(0, maxBuffer - bufferSize)
+        bufferSize += Math.min(remaining, data.length)
+        if (data.length > remaining) {
+          error = new Error('maxBuffer exceeded')
+          child.kill(killSignal ?? 'SIGTERM')
+          data = data.subarray(0, remaining)
+        }
+        chunks.push(data)
+      }
+      const captureStdout = stdoutChunks ? capture(stdoutChunks) : undefined
+      const captureStderr = stderrChunks ? capture(stderrChunks) : undefined
+      if (captureStdout) child.stdout?.on('data', captureStdout)
+      if (captureStderr) child.stderr?.on('data', captureStderr)
+      function onError(err: Error) {
+        error = err
+        done()
+      }
+      child.on('error', onError)
+      function done(code: number | null = null, signal: string | null = null) {
+        child.removeListener('error', onError)
+        child.removeListener('close', done)
+        if (captureStdout) child.stdout?.removeListener('data', captureStdout)
+        if (captureStderr) child.stderr?.removeListener('data', captureStderr)
+
+        const stdout = joinChunks(
+          stdoutChunks,
+          encoding
+        ) as ChildProcessResult<Options>['stdout']
+        const stderr = joinChunks(
+          stderrChunks,
+          encoding
+        ) as ChildProcessResult<Options>['stderr']
+
+        if (error || (code != null && code != 0) || signal != null) {
+          reject(
+            Object.assign(
+              error ||
+                new Error(
+                  signal != null ?
+                    `Process was killed with ${signal}`
+                  : `Process exited with code ${code}`
+                ),
+              {
+                code,
+                signal,
+                killed: signal != null,
+                stdout,
+                stderr,
+              }
+            )
+          )
+        } else {
+          resolve({ stderr, stdout, code, signal, killed: false })
+        }
+      }
+      child.on('close', done)
+    }
+  )
+  return Object.create(child, {
+    then: { value: promise.then.bind(promise) },
+    catch: { value: promise.catch.bind(promise) },
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    finally: { value: promise.finally?.bind(promise) },
+  })
+}
+
+export interface SpawnOptions extends child_process.SpawnOptions {
+  encoding?: BufferEncoding
+  maxBuffer?: number
+}
+
+function isArray(t: unknown): t is unknown[] | readonly unknown[] {
+  return Array.isArray(t)
+}
+
+export function spawn<Options extends SpawnOptions>(
+  command: string,
+  args: readonly string[],
+  options?: Options
+): ChildProcessPromise<Options>
+export function spawn<Options extends SpawnOptions>(
+  command: string,
+  options?: Options
+): ChildProcessPromise<Options>
+export function spawn<Options extends SpawnOptions>(
+  command: string,
+  args?: readonly string[] | Options,
+  options?: Options
+): ChildProcessPromise<Options> {
+  if (!isArray(args)) {
+    options = args
+    args = []
+  }
+  return promisifyChildProcess(
+    child_process.spawn(command, args, options as child_process.SpawnOptions),
+    options
+  )
+}
+
+export interface ForkOptions extends child_process.ForkOptions {
+  encoding?: BufferEncoding
+  maxBuffer?: number
+}
+
+export function fork<Options extends ForkOptions>(
+  module: string,
+  args: Array<string>,
+  options?: Options
+): ChildProcessPromise<Options>
+export function fork<Options extends ForkOptions>(
+  module: string,
+  options?: Options
+): ChildProcessPromise<Options>
+export function fork<Options extends ForkOptions>(
+  module: string,
+  args?: Array<string> | Options,
+  options?: Options
+): ChildProcessPromise<Options> {
+  if (!isArray(args)) {
+    options = args
+    args = []
+  }
+  return promisifyChildProcess(
+    child_process.fork(module, args, options),
+    options
+  )
+}
+function promisifyExecMethod(method: (...args: any[]) => ChildProcess) {
+  return (...args: any[]): ChildProcessPromise<any> => {
+    let child: ChildProcess | undefined
+    const promise = new Promise<ChildProcessResult<any>>((resolve, reject) => {
+      child = method(
+        ...args,
+        (
+          err: Error | null,
+          stdout: string | Buffer,
+          stderr: string | Buffer
+        ) => {
+          if (err) {
+            reject(Object.assign(err, { stdout, stderr }))
+          } else {
+            resolve({
+              code: 0,
+              signal: null,
+              killed: false,
+              stdout: stdout as any,
+              stderr: stderr as any,
+            })
+          }
+        }
+      )
+    })
+    if (!child) {
+      throw new Error('unexpected error: child has not been initialized')
+    }
+    return Object.create(child, {
+      then: { value: promise.then.bind(promise) },
+      catch: { value: promise.catch.bind(promise) },
+      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+      finally: { value: promise.finally?.bind(promise) },
+    })
+  }
+}
+
+export interface ExecOptions extends child_process.ExecOptions {
+  encoding?: BufferEncoding | 'buffer'
+}
+
+export const exec: <Options extends ExecOptions>(
+  command: string,
+  options?: Options
+) => ChildProcessPromise<Options> = promisifyExecMethod(child_process.exec)
+
+export interface ExecFileOptions extends child_process.ExecFileOptions {
+  encoding?: BufferEncoding | 'buffer'
+}
+
+export const execFile: {
+  <Options extends ExecFileOptions>(
+    file: string,
+    args: readonly string[],
+    options?: Options
+  ): ChildProcessPromise<Options>
+  <Options extends ExecFileOptions>(
+    file: string,
+    options?: Options
+  ): ChildProcessPromise<Options>
+} = promisifyExecMethod(child_process.execFile)
+
+export function isChildProcessError(error: unknown): error is Error & {
+  code: number | null
+  signal: NodeJS.Signals | null
+  killed: boolean
+  stdout?: string | Buffer
+  stderr?: string | Buffer
+} {
+  return error instanceof Error && 'code' in error && 'signal' in error
+}