Skip to content

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.

3 exports Added in v4.0.0 Source

Layers

layer

Added in v4.0.0 Source

Layer that provides the NodeChildProcessSpawner implementation.

Signature

declare const layer: Layer.Layer<ChildProcessSpawner, never, FileSystem.FileSystem | Path.Path>;

Models

FlattenedPipeline interface

Added in v4.0.0 Source

Result of flattening a pipeline of commands.

Signature

interface FlattenedPipeline {
  readonly commands: readonly [StandardCommand, StandardCommand];
  readonly pipeOptions: readonly Array<PipeOptions>;
}

Transforming

flattenCommand

Added in v4.0.0 Source

Flattens a Command into an array of StandardCommands along with pipe options for each connection.

Signature

declare function flattenCommand(command: Command): FlattenedPipeline;