feat: configurable maxBuffer spawn option (#337)

* feat: add default spawn properties override: `timeout`, `killSignal` and `maxBuffer`

* refactor: store spawn opts as `$` own values

* revert: rm spawn timeout option

README.md

@@ -316,6 +316,11 @@ Or use a CLI argument: `--shell=/bin/bash`
 
 Specifies a `spawn` api. Defaults to `require('child_process').spawn`.
 
+#### `$.maxBuffer`
+
+Specifies the largest number of bytes allowed on stdout or stderr.
+Defaults to `200 * 1024 * 1024` (200 MiB).
+
 #### `$.prefix`
 
 Specifies the command that will be prefixed to all commands run.

index.d.ts

@@ -31,6 +31,7 @@ interface $ {
   prefix: string
   quote: (input: string) => string
   spawn: typeof spawn
+  maxBuffer?: number | undefined
 }
 
 export interface ProcessPromise<T> extends Promise<T> {

index.mjs

@@ -56,7 +56,7 @@ export function registerGlobals() {
 }
 
 export function $(pieces, ...args) {
-  let {verbose, shell, prefix} = $
+  let {verbose, shell, prefix, spawn, maxBuffer = 200 * 1024 * 1024 /* 200 MiB*/} = $
   let __from = (new Error().stack.split(/^\s*at\s/m)[2]).trim()
 
   let cmd = pieces[0], i = 0
@@ -80,12 +80,12 @@ export function $(pieces, ...args) {
       printCmd(cmd)
     }
 
-    let child = $.spawn(prefix + cmd, {
+    let child = spawn(prefix + cmd, {
       cwd: process.cwd(),
       shell: typeof shell === 'string' ? shell : true,
       stdio: [promise._inheritStdin ? 'inherit' : 'pipe', 'pipe', 'pipe'],
       windowsHide: true,
-      maxBuffer: 200 * 1024 * 1024, // 200 MiB
+      maxBuffer,
     })
 
     child.on('close', (code, signal) => {