NodeChildProcessSpawner
Shared Node.js implementation of the child process spawner service.
This module adapts node:child_process.spawn to the Effect
ChildProcessSpawner service. Provide layer to run ChildProcess
commands in Node-compatible runtimes: commands get scoped process handles
with stdin sinks, stdout and stderr streams, exit-code waiting,
interruption-time cleanup, process killing, and custom file-descriptor pipes.
The implementation sits below the command-building API. It validates and
resolves cwd through the Effect FileSystem and Path services,
translates Node errno failures to PlatformError, and uses scopes to
terminate referenced children when the owning effect is interrupted or
finalized. Pipelines are flattened by flattenCommand and spawned one
process at a time, wiring the selected source stream (stdout, stderr,
all, or fdN) to the destination stdin or fdN.
Scoped release and kill wait for the signalled process group. Without
forceKillAfter, the wait is limited to one second and never escalates.
With it, cleanup may take the configured duration plus a final one-second
wait after SIGKILL. Zombie descendants can consume either full bound. On
Windows, taskkill terminates the tree and only the leader's exit is awaited.
Layers
Models
FlattenedPipeline interface
Result of flattening a pipeline of commands.
Signature
interface FlattenedPipeline { readonly commands: readonly [StandardCommand, StandardCommand]; readonly pipeOptions: readonly Array<PipeOptions>;}Transforming
flattenCommand
Flattens a Command into an array of StandardCommands along with pipe
options for each connection.
Signature
declare function flattenCommand(command: Command): FlattenedPipeline