procband 0.2.1 → 0.2.2

package/README.md

@@ -29,6 +29,9 @@ const result = await proc
 console.log(result)
 ```
 
+`stdin` is disabled by default. Set `stdin: true` to write to `proc.stdin`, or
+pass a readable stream to `stdin` to pipe input automatically.
+
 ## Documentation Map
 
 - Concepts and lifecycle: [docs/context.md](docs/context.md)

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { ChildProcess } from "node:child_process";
-import { Writable } from "node:stream";
+import { Readable, Writable } from "node:stream";
 
 //#region src/types.d.ts
 /**
@@ -67,6 +67,14 @@ interface ProcessConfig {
    * `process.stderr`.
    */
   stderr?: Writable;
+  /**
+   * Child stdin behavior.
+   *
+   * Defaults to `false`, which connects the child stdin to the null device.
+   * Use `true` to expose a writable `proc.stdin`, or pass a readable stream to
+   * pipe bytes into the child automatically.
+   */
+  stdin?: boolean | Readable;
   /**
    * Automatic restart behavior for terminal child exits.
    *

package/dist/index.mjs

@@ -516,7 +516,7 @@ var ProcbandProcessImpl = class extends EventEmitter {
 			cwd: this.config.cwd,
 			env: this.config.env,
 			stdio: [
-				"pipe",
+				this.config.stdin ? "pipe" : "ignore",
 				"pipe",
 				"pipe"
 			]
@@ -537,13 +537,15 @@ var ProcbandProcessImpl = class extends EventEmitter {
 				text: "",
 				flushed: false
 			},
-			closed: false
+			closed: false,
+			stdinCleanup: null
 		};
 		this.attempt = attempt;
 		this.attachAttempt(attempt);
 	}
 	attachAttempt(attempt) {
 		const { child } = attempt;
+		attempt.stdinCleanup = this.bindAttemptStdin(attempt);
 		child.on("spawn", () => {
 			if (this.attempt === attempt) this.emit("spawn");
 		});
@@ -556,6 +558,8 @@ var ProcbandProcessImpl = class extends EventEmitter {
 		child.on("close", (code, signal) => {
 			if (this.attempt !== attempt) return;
 			attempt.closed = true;
+			attempt.stdinCleanup?.();
+			attempt.stdinCleanup = null;
 			this.flushLineBuffer(attempt, "stdout");
 			this.flushLineBuffer(attempt, "stderr");
 			attempt.settleClose({
@@ -682,6 +686,15 @@ var ProcbandProcessImpl = class extends EventEmitter {
 		buffer.text = "";
 		this.handleLine(stream, line, false);
 	}
+	bindAttemptStdin(attempt) {
+		const source = this.config.stdin;
+		const destination = attempt.child.stdin;
+		if (!destination || typeof source !== "object") return null;
+		source.pipe(destination);
+		return () => {
+			source.unpipe(destination);
+		};
+	}
 };
 const liveProcesses = /* @__PURE__ */ new Set();
 let propagatedFailure = false;

package/docs/context.md

@@ -35,8 +35,8 @@ Supervision adds four behaviors on top of raw `spawn()`:
 # Core Abstractions
 
 - `ProcessConfig`
-  Declares one supervised subprocess plus its label, color, restart policy, and
-  optional raw `stderr` tee.
+  Declares one supervised subprocess plus its label, color, restart policy,
+  optional stdin behavior, and optional raw `stderr` tee.
 - `ProcbandProcess`
   The live wrapper returned by `supervise()`. It is a `ChildProcess`-compatible
   handle, a matching surface, a shutdown surface, and a thenable final result.
@@ -52,14 +52,17 @@ Supervision adds four behaviors on top of raw `spawn()`:
 3. Each line is prefixed and written to the parent `process.stdout` or
    `process.stderr`.
 4. `stderr` can also be tee'd as raw bytes to `ProcessConfig.stderr`.
-5. Future matching lines are delivered through `match()` callbacks or
+5. `stdin` is disconnected by default. Set `ProcessConfig.stdin` to `true` for
+   a writable child stdin, or pass a readable stream to pipe input into the
+   child automatically.
+6. Future matching lines are delivered through `match()` callbacks or
    `waitFor()`.
-6. When a child exits, `procband` either finalizes or starts a new attempt,
+7. When a child exits, `procband` either finalizes or starts a new attempt,
    depending on the restart policy.
-7. A terminal failed exit that nobody observed through `await proc` or
+8. A terminal failed exit that nobody observed through `await proc` or
    `proc.wait()` sets `process.exitCode` and begins
    stopping any other live `procband` processes in the same parent script.
-8. `await proc` or `await proc.wait()` resolves only after the process is
+9. `await proc` or `await proc.wait()` resolves only after the process is
    terminal and no further restart will happen.
 
 # Common Tasks -> Recommended APIs
@@ -78,6 +81,10 @@ Supervision adds four behaviors on top of raw `spawn()`:
   Do not call `wait()` or await the thenable result
 - Capture raw child `stderr` in a file or custom stream:
   `ProcessConfig.stderr`
+- Write to child stdin manually:
+  `stdin: true`, then `proc.stdin?.write(...)`
+- Pipe a custom input stream into the child:
+  `stdin: readable`
 - Retry failed exits with sane defaults:
   `restart: true`
 - Use explicit retry rules:
@@ -102,7 +109,7 @@ Supervision adds four behaviors on top of raw `spawn()`:
   processes in the same parent script.
 - The wrapper survives restarts, but inherited `pid`, `stdin`, `stdout`,
   `stderr`, and related `ChildProcess` fields always refer to the current active
-  child attempt.
+  child attempt. `stdin` is `null` unless `ProcessConfig.stdin` is enabled.
 - `kill()` only signals the current direct child. `stop()` disables restart and
   kills the full process tree.
 - Parent cleanup installs both `SIGINT` and `SIGTERM` handlers while any live

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "procband",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Supervise subprocesses from TypeScript: prefix logs, wait for output patterns, and manage lifecycle/restarts.",
   "license": "MIT",
   "author": "Alec Larson",