@henryqw/pi-process

Run one argv-only child process with bounded UTF-8 output, cancellation, and a timeout.

Install

npm install @henryqw/pi-process

Use

import { spawnBounded } from "@henryqw/pi-process";

const result = await spawnBounded("git", ["status"], { cwd: process.cwd() });
if (result.code !== 0 || result.killed) throw new Error(result.stderr);

spawnBounded accepts an optional UTF-8 string on stdin. It strictly decodes stdout and stderr. The default timeout is 30 seconds. Pass timeoutMs: null for a process that should have no elapsed-time limit; cancellation and output limits still apply. Each output stream is limited to 64 KiB. Set stdoutTailBytes to retain a UTF-8-safe tail instead of applying the stdout limit.

On POSIX systems, cancellation and timeout terminate the child process group. Invalid command, argument, and working-directory values fail before a child starts.

API

| Surface | Type | Purpose | | --- | --- | --- | | spawnBounded | function | Run one bounded argv-only child process. | | Exec | type | Describe the executor call signature. | | ExecOptions | type | Configure cwd, cancellation, timeout, limits, and string stdin. | | ExecResult | type | Return stdout, stderr, exit code, kill state, and tail truncation. |