@smthrs/platform-node 0.0.0-stage → 1.0.0-rc.4

package/dist/esm/internal/PipedProcess.js

@@ -0,0 +1,321 @@
+/**
+ * Native I/O ownership for transient commands and prepared process owners.
+ * @since 1.0.0
+ */
+import * as NodeSink from "../../vendor/node/NodeSink.js";
+import * as NodeStream from "../../vendor/node/NodeStream.js";
+import * as Effect from "effect/Effect";
+import * as PlatformError from "effect/PlatformError";
+import * as Sink from "effect/Sink";
+import * as Stream from "effect/Stream";
+import * as ChildProcess from "effect/unstable/process/ChildProcess";
+import { ExitCode, makeHandle, ProcessId } from "effect/unstable/process/ChildProcessSpawner";
+import * as Native from "node:child_process";
+import { NativeProcessError } from "./ProcessFault.js";
+const ownerDescriptors = new WeakMap();
+/**
+ * Windows owners receive caller streams above the reserved CRT standard slots.
+ * @private
+ * @since 1.0.0
+ */
+export const standardFdsOf = (handle) => ownerDescriptors.get(handle);
+const promise = () => {
+    let resolve;
+    let reject;
+    const promise = new Promise((onSuccess, onFailure) => {
+        resolve = onSuccess;
+        reject = onFailure;
+    });
+    void promise.catch(() => { });
+    return { promise, resolve, reject };
+};
+/**
+ * Converts native errors without losing their errno or signal.
+ * @private
+ * @since 1.0.0
+ */
+export const failure = (method, cause) => {
+    const error = cause instanceof Error ? cause : new NativeProcessError({ message: String(cause) });
+    const code = error.code;
+    return PlatformError.systemError({
+        _tag: code === "ENOENT" ? "NotFound" : code === "EACCES" || code === "EPERM" ? "PermissionDenied" : "Unknown",
+        module: "ChildProcess",
+        method,
+        description: error.message,
+        cause: error
+    });
+};
+const inputConfig = (value) => value === undefined || typeof value === "string" || Stream.isStream(value)
+    ? { stream: value ?? "pipe" }
+    : value;
+const outputConfig = (value) => value === undefined || typeof value === "string" || Sink.isSink(value)
+    ? value ?? "pipe"
+    : value.stream ?? "pipe";
+const descriptorConfig = (options) => {
+    const stdin = inputConfig(options.stdin);
+    const stdout = outputConfig(options.stdout);
+    const stderr = outputConfig(options.stderr);
+    const additional = [];
+    for (const [name, config] of Object.entries(options.additionalFds ?? {})) {
+        const fd = ChildProcess.parseFdName(name);
+        if (fd === undefined)
+            continue;
+        // A sparse descriptor declaration must not allocate an unbounded stdio
+        // table. The OS may impose a smaller limit when opening the actual pipes.
+        if (!Number.isSafeInteger(fd) || fd > 65_535) {
+            throw new RangeError("Additional file descriptors must be below 65536");
+        }
+        additional.push({ fd, config });
+    }
+    additional.sort((left, right) => left.fd - right.fd);
+    const stdio = Array.from({ length: Math.max(2, ...additional.map(({ fd }) => fd)) + 1 }, () => "ignore");
+    stdio[0] = typeof stdin.stream === "string" ? stdin.stream : "pipe";
+    stdio[1] = typeof stdout === "string" ? stdout : "pipe";
+    stdio[2] = typeof stderr === "string" ? stderr : "pipe";
+    for (const { fd } of additional)
+        stdio[fd] = "pipe";
+    return { stdin, stdout, stderr, additional, stdio };
+};
+/**
+ * Native standard-command I/O, including configured streams and custom pipes.
+ * Lifetime error listeners remain on every owned pipe after any consumer is
+ * interrupted, so a pending native write cannot raise an unhandled late EPIPE.
+ * Consumers still receive the original error through NodeStream/NodeSink.
+ * This adapter also preserves native Windows verbatim arguments.
+ *
+ * It never sends a negative-pid signal. POSIX tree cleanup belongs to the
+ * prepared supervisor, which remains alive while it signals its own group.
+ * @private
+ * @since 1.0.0
+ */
+export const spawn = (command, windowsVerbatimArguments, owner = false) => Effect.gen(function* () {
+    const descriptors = yield* Effect.try({
+        try: () => descriptorConfig(command.options),
+        catch: (cause) => failure("spawn", cause)
+    });
+    const standardFds = [0, 1, 2];
+    const physicalFds = [0, 1, 2];
+    const stdio = [...descriptors.stdio];
+    if (owner && process.platform === "win32") {
+        const first = stdio.length;
+        for (const fd of [0, 1, 2]) {
+            const mode = stdio[fd];
+            physicalFds[fd] = first + fd;
+            standardFds[fd] = mode === "ignore" ? "ignore" : first + fd;
+            stdio.push(mode === "inherit" ? fd : mode);
+            stdio[fd] = "ignore";
+        }
+    }
+    const state = yield* Effect.acquireRelease(Effect.try({
+        try: () => {
+            const ready = promise();
+            // Startup errors reject ready before any handle is exposed. Once
+            // started, the native exit event or retained native status supplies
+            // this result.
+            let recordExit;
+            const exited = new Promise((resolve) => {
+                recordExit = resolve;
+            });
+            const options = command.options;
+            const child = Native.spawn(command.command, [...command.args], {
+                cwd: options.cwd,
+                env: options.extendEnv ? { ...process.env, ...options.env } : options.env,
+                shell: options.shell,
+                detached: options.detached ?? process.platform !== "win32",
+                windowsHide: options.windowsHide ?? true,
+                windowsVerbatimArguments,
+                stdio
+            });
+            const state = {
+                child,
+                ready: ready.promise,
+                exited,
+                ended: false,
+                started: false,
+                referenced: true,
+                pipeErrors: new WeakMap(),
+                error: undefined
+            };
+            child.once("spawn", () => {
+                state.started = true;
+                ready.resolve();
+            });
+            child.on("error", (error) => {
+                state.error = error;
+                if (!state.started) {
+                    state.ended = true;
+                    ready.reject(error);
+                }
+            });
+            const onExit = (code, signal) => {
+                state.ended = true;
+                recordExit([code, signal]);
+            };
+            child.once("exit", onExit);
+            // Bun can emit spawn before Native.spawn returns on a cold start.
+            // A returned pid proves that the native child was created; failed
+            // native spawns have no pid and still reject through the error event.
+            if (child.pid !== undefined) {
+                state.started = true;
+                ready.resolve();
+            }
+            // Likewise retain an exit already reflected by the native handle
+            // before listeners could attach. Later events settle the same result.
+            if (child.exitCode != null || child.signalCode != null) {
+                onExit(child.exitCode ?? null, child.signalCode ?? null);
+            }
+            // A pipe can fail before a consumer has started reading or writing.
+            // Preserve the cause for consumers that attach after its error event.
+            for (const pipe of child.stdio) {
+                pipe?.on("error", (error) => {
+                    state.pipeErrors.set(pipe, error);
+                });
+            }
+            // Node resumes unread stdio after exit to deliver its close event.
+            // A fast target can exit before activation returns the public handle;
+            // flowing at that point discards bytes before any consumer subscribes.
+            // Keep declared outputs in readable mode for their entire lifetime.
+            // This listener does not drain or copy data: the native high-water
+            // mark still applies backpressure until NodeStream pulls the bytes.
+            for (const fd of [
+                physicalFds[1],
+                physicalFds[2],
+                ...descriptors.additional.filter(({ config }) => config.type === "output").map(({ fd }) => fd)
+            ]) {
+                const pipe = child.stdio[fd];
+                pipe?.on("readable", () => { });
+                // POSIX sockets can close the unused writer independently. Bun
+                // needs this to retain buffered output after child exit. Windows
+                // named-pipe shutdown instead starts libuv's EOF timer, which can
+                // close both directions before the child writes. Leave it open.
+                if (process.platform !== "win32" && fd > 2 && pipe !== null && pipe !== undefined && "end" in pipe) {
+                    pipe.end();
+                }
+            }
+            return state;
+        },
+        catch: (cause) => failure("spawn", cause)
+    }), (state) => Effect.gen(function* () {
+        if (state.referenced && !state.ended) {
+            yield* Effect.try({
+                try: () => {
+                    // Native kill returns false for an exit whose event is still
+                    // queued. Require that event below; never infer a live failure
+                    // or successful cleanup from the boolean alone.
+                    if (!state.child.kill("SIGKILL") && state.error !== undefined)
+                        throw state.error;
+                },
+                catch: (cause) => failure("kill", cause)
+            });
+            yield* Effect.promise(() => state.exited).pipe(Effect.timeout("2 seconds"));
+        }
+    }).pipe(Effect.ensuring(Effect.sync(() => {
+        for (const pipe of state.child.stdio) {
+            if (pipe !== null && pipe !== undefined && "destroy" in pipe && typeof pipe.destroy === "function") {
+                pipe.destroy();
+            }
+        }
+    })), Effect.orDie));
+    yield* Effect.tryPromise({ try: () => state.ready, catch: (cause) => failure("spawn", cause) });
+    const wait = Effect.promise(() => state.exited);
+    const kill = (options) => Effect.suspend(() => {
+        if (state.ended)
+            return Effect.void;
+        const signal = options?.killSignal ?? command.options.killSignal ?? "SIGTERM";
+        const send = (signal) => Effect.try({
+            try: () => {
+                if (!state.child.kill(signal) && state.error !== undefined)
+                    throw state.error;
+            },
+            catch: (cause) => failure("kill", cause)
+        });
+        return send(signal).pipe(Effect.andThen(wait.pipe(Effect.timeoutOrElse({
+            duration: options?.forceKillAfter ?? command.options.forceKillAfter ?? 2000,
+            orElse: () => send("SIGKILL").pipe(Effect.andThen(wait), Effect.timeout("2 seconds"))
+        }))), Effect.mapError((cause) => cause instanceof PlatformError.PlatformError ? cause : failure("kill", cause)), Effect.asVoid, Effect.uninterruptible);
+    });
+    const input = (fd, config) => {
+        const pipe = state.child.stdio[fd];
+        if (pipe === null || pipe === undefined || !("write" in pipe))
+            return Sink.drain;
+        const writable = pipe;
+        const method = fd === 0 ? "stdin" : `fd${fd}`;
+        return Sink.suspend(() => {
+            const error = state.pipeErrors.get(pipe) ?? writable.errored ?? undefined;
+            if (error !== undefined)
+                return Sink.fail(failure(method, error));
+            if (writable.destroyed || writable.writableEnded) {
+                return Sink.fail(failure(method, new NativeProcessError({ message: `${method} is closed`, code: "EPIPE" })));
+            }
+            return NodeSink.fromWritable({
+                evaluate: () => writable,
+                onError: (cause) => failure(method, cause),
+                encoding: config?.encoding,
+                endOnDone: config?.endOnDone
+            });
+        });
+    };
+    const output = (fd, transform) => {
+        const pipe = state.child.stdio[fd];
+        const stream = pipe !== null && pipe !== undefined && "read" in pipe
+            ? Stream.suspend(() => {
+                const method = fd === 1 ? "stdout" : fd === 2 ? "stderr" : `fd${fd}`;
+                const error = state.pipeErrors.get(pipe) ?? pipe.errored ?? undefined;
+                return error !== undefined ?
+                    Stream.fail(failure(method, error)) :
+                    NodeStream.fromReadable({
+                        evaluate: () => pipe,
+                        onError: (cause) => failure(method, cause)
+                    });
+            })
+            : Stream.empty;
+        return Sink.isSink(transform) ? Stream.transduce(stream, transform) : stream;
+    };
+    const stdin = input(physicalFds[0], descriptors.stdin);
+    const stdout = output(physicalFds[1], descriptors.stdout);
+    const stderr = output(physicalFds[2], descriptors.stderr);
+    if (Stream.isStream(descriptors.stdin.stream)) {
+        yield* Stream.run(descriptors.stdin.stream, stdin).pipe(Effect.forkScoped);
+    }
+    const inputs = new Map();
+    const outputs = new Map();
+    for (const { fd, config } of descriptors.additional) {
+        if (config.type === "input") {
+            const sink = input(fd);
+            inputs.set(fd, sink);
+            if (config.stream !== undefined)
+                yield* Stream.run(config.stream, sink).pipe(Effect.forkScoped);
+        }
+        else
+            outputs.set(fd, output(fd, config.sink));
+    }
+    const handle = makeHandle({
+        pid: ProcessId(state.child.pid),
+        exitCode: wait.pipe(Effect.flatMap(([code, signal]) => code === null
+            ? Effect.fail(failure("exitCode", new NativeProcessError({
+                message: `Process interrupted due to receipt of signal: '${signal}'`,
+                signal: String(signal)
+            })))
+            : Effect.succeed(ExitCode(code)))),
+        isRunning: Effect.sync(() => !state.ended),
+        kill,
+        stdin,
+        stdout,
+        stderr,
+        all: Stream.merge(stdout, stderr),
+        getInputFd: (fd) => inputs.get(fd) ?? Sink.drain,
+        getOutputFd: (fd) => outputs.get(fd) ?? Stream.empty,
+        unref: Effect.sync(() => {
+            state.referenced = false;
+            state.child.unref();
+            return Effect.sync(() => {
+                state.referenced = true;
+                state.child.ref();
+            });
+        })
+    });
+    if (owner && process.platform === "win32")
+        ownerDescriptors.set(handle, standardFds);
+    return handle;
+});
+//# sourceMappingURL=PipedProcess.js.map

package/dist/esm/internal/PipedProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PipedProcess.js","sourceRoot":"","sources":["../../../src/internal/PipedProcess.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,QAAQ,MAAM,gCAAgC,CAAA;AAC1D,OAAO,KAAK,UAAU,MAAM,kCAAkC,CAAA;AAC9D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAA;AAErD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAA;AACnC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,YAAY,MAAM,sCAAsC,CAAA;AACpE,OAAO,EAA2B,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,6CAA6C,CAAA;AACtH,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAwD,CAAA;AAE5F;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAA0B,EAAgD,EAAE,CACxG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AAE9B,MAAM,OAAO,GAAG,GAAM,EAAE;IACtB,IAAI,OAA4B,CAAA;IAChC,IAAI,MAAiC,CAAA;IACrC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE;QACtD,OAAO,GAAG,SAAS,CAAA;QACnB,MAAM,GAAG,SAAS,CAAA;IACpB,CAAC,CAAC,CAAA;IACF,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAC5B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;AACrC,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,KAAc,EAA+B,EAAE;IACrF,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACjG,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAA;IAClD,OAAO,aAAa,CAAC,WAAW,CAAC;QAC/B,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS;QAC7G,MAAM,EAAE,cAAc;QACtB,MAAM;QACN,WAAW,EAAE,KAAK,CAAC,OAAO;QAC1B,KAAK,EAAE,KAAK;KACb,CAAC,CAAA;AACJ,CAAC,CAAA;AAED,MAAM,WAAW,GAAG,CAAC,KAA2C,EAA4B,EAAE,CAC5F,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;IACxE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,MAAM,EAAE;IAC7B,CAAC,CAAC,KAAK,CAAA;AAEX,MAAM,YAAY,GAAG,CACnB,KAA4C,EAChB,EAAE,CAC9B,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IACpE,CAAC,CAAC,KAAK,IAAI,MAAM;IACjB,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,MAAM,CAAA;AAE5B,MAAM,gBAAgB,GAAG,CAAC,OAAoC,EAAE,EAAE;IAChE,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACxC,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3C,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3C,MAAM,UAAU,GAAqF,EAAE,CAAA;IACvG,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,CAAC;QACzE,MAAM,EAAE,GAAG,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;QACzC,IAAI,EAAE,KAAK,SAAS;YAAE,SAAQ;QAC9B,uEAAuE;QACvE,0EAA0E;QAC1E,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;YAC7C,MAAM,IAAI,UAAU,CAAC,iDAAiD,CAAC,CAAA;QACzE,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IACjC,CAAC;IACD,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC,CAAA;IACpD,MAAM,KAAK,GAAyB,KAAK,CAAC,IAAI,CAC5C,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAC9D,GAAG,EAAE,CAAC,QAAQ,CACf,CAAA;IACD,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;IACnE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;IACvD,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAA;IACvD,KAAK,MAAM,EAAE,EAAE,EAAE,IAAI,UAAU;QAAE,KAAK,CAAC,EAAE,CAAC,GAAG,MAAM,CAAA;IACnD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AACrD,CAAC,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CACnB,OAAqC,EACrC,wBAA6C,EAC7C,KAAK,GAAG,KAAK,EACgE,EAAE,CAC/E,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACpC,GAAG,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC;QAC5C,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;KAC1C,CAAC,CAAA;IACF,MAAM,WAAW,GAA6B,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACvD,MAAM,WAAW,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC7B,MAAM,KAAK,GAAkC,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;IACnE,IAAI,KAAK,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAA;QAC1B,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAE,CAAA;YACvB,WAAW,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,EAAE,CAAA;YAC5B,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAA;YAC3D,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;YAC1C,KAAK,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAA;QACtB,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,cAAc,CACxC,MAAM,CAAC,GAAG,CAAC;QACT,GAAG,EAAE,GAAG,EAAE;YACR,MAAM,KAAK,GAAG,OAAO,EAAQ,CAAA;YAC7B,iEAAiE;YACjE,oEAAoE;YACpE,eAAe;YACf,IAAI,UAA8E,CAAA;YAClF,MAAM,MAAM,GAAG,IAAI,OAAO,CAAkD,CAAC,OAAO,EAAE,EAAE;gBACtF,UAAU,GAAG,OAAO,CAAA;YACtB,CAAC,CAAC,CAAA;YACF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;YAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE;gBAC7D,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG;gBACzE,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;gBAC1D,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;gBACxC,wBAAwB;gBACxB,KAAK;aACN,CAAC,CAAA;YACF,MAAM,KAAK,GAAG;gBACZ,KAAK;gBACL,KAAK,EAAE,KAAK,CAAC,OAAO;gBACpB,MAAM;gBACN,KAAK,EAAE,KAAK;gBACZ,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,IAAI;gBAChB,UAAU,EAAE,IAAI,OAAO,EAAiB;gBACxC,KAAK,EAAE,SAA8B;aACtC,CAAA;YACD,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;gBACvB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;gBACpB,KAAK,CAAC,OAAO,EAAE,CAAA;YACjB,CAAC,CAAC,CAAA;YACF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC1B,KAAK,CAAC,KAAK,GAAG,KAAK,CAAA;gBACnB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;oBACnB,KAAK,CAAC,KAAK,GAAG,IAAI,CAAA;oBAClB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACrB,CAAC;YACH,CAAC,CAAC,CAAA;YACF,MAAM,MAAM,GAAG,CAAC,IAAmB,EAAE,MAA6B,EAAE,EAAE;gBACpE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAA;gBAClB,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAA;YAC5B,CAAC,CAAA;YACD,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YAC1B,kEAAkE;YAClE,kEAAkE;YAClE,sEAAsE;YACtE,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC5B,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;gBACpB,KAAK,CAAC,OAAO,EAAE,CAAA;YACjB,CAAC;YACD,iEAAiE;YACjE,sEAAsE;YACtE,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,CAAC;gBACvD,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,CAAA;YAC1D,CAAC;YACD,oEAAoE;YACpE,sEAAsE;YACtE,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;oBACjC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;gBACnC,CAAC,CAAC,CAAA;YACJ,CAAC;YACD,mEAAmE;YACnE,sEAAsE;YACtE,uEAAuE;YACvE,oEAAoE;YACpE,mEAAmE;YACnE,oEAAoE;YACpE,KACE,MAAM,EAAE,IAAI;gBACV,WAAW,CAAC,CAAC,CAAE;gBACf,WAAW,CAAC,CAAC,CAAE;gBACf,GAAG,WAAW,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;aAC/F,EACD,CAAC;gBACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;gBAC5B,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;gBAC9B,+DAA+D;gBAC/D,iEAAiE;gBACjE,kEAAkE;gBAClE,gEAAgE;gBAChE,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;oBACnG,IAAI,CAAC,GAAG,EAAE,CAAA;gBACZ,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC;QACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;KAC1C,CAAC,EACF,CAAC,KAAK,EAAE,EAAE,CACR,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACrC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBAChB,GAAG,EAAE,GAAG,EAAE;oBACR,6DAA6D;oBAC7D,+DAA+D;oBAC/D,gDAAgD;oBAChD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;wBAAE,MAAM,KAAK,CAAC,KAAK,CAAA;gBAClF,CAAC;gBACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC;aACzC,CAAC,CAAA;YACF,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAC5C,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAC5B,CAAA;QACH,CAAC;IACH,CAAC,CAAC,CAAC,IAAI,CACL,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,SAAS,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBACnG,IAAI,CAAC,OAAO,EAAE,CAAA;YAChB,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC,EACH,MAAM,CAAC,KAAK,CACb,CACJ,CAAA;IACD,KAAK,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;IAC/F,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC/C,MAAM,IAAI,GAA+B,CAAC,OAAO,EAAE,EAAE,CACnD,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,KAAK,CAAC,KAAK;YAAE,OAAO,MAAM,CAAC,IAAI,CAAA;QACnC,MAAM,MAAM,GAAG,OAAO,EAAE,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,SAAS,CAAA;QAC7E,MAAM,IAAI,GAAG,CAAC,MAA2B,EAAE,EAAE,CAC3C,MAAM,CAAC,GAAG,CAAC;YACT,GAAG,EAAE,GAAG,EAAE;gBACR,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;oBAAE,MAAM,KAAK,CAAC,KAAK,CAAA;YAC/E,CAAC;YACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC;SACzC,CAAC,CAAA;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CACtB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;YAC5C,QAAQ,EAAE,OAAO,EAAE,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,cAAc,IAAI,IAAI;YAC3E,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;SACtF,CAAC,CAAC,CAAC,EACJ,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,YAAY,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EACzG,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,eAAe,CACvB,CAAA;IACH,CAAC,CAAC,CAAA;IACJ,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,MAAiC,EAA+B,EAAE;QAC3F,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAClC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAA;QAChF,MAAM,QAAQ,GAAG,IAAI,CAAA;QACrB,MAAM,MAAM,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAA;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YACvB,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,OAAO,IAAI,SAAS,CAAA;YACzE,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;YACjE,IAAI,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;gBACjD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;YAC9G,CAAC;YACD,OAAO,QAAQ,CAAC,YAAY,CAAC;gBAC3B,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ;gBACxB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC;gBAC1C,QAAQ,EAAE,MAAM,EAAE,QAAQ;gBAC1B,SAAS,EAAE,MAAM,EAAE,SAAS;aAC7B,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IACD,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,SAAsC,EAAgC,EAAE;QAClG,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QAClC,MAAM,MAAM,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,IAAI,IAAI;YAClE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;gBACpB,MAAM,MAAM,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAA;gBACpE,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,IAAI,SAAS,CAAA;gBACrE,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC;oBAC1B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;oBACrC,UAAU,CAAC,YAAY,CAA0C;wBAC/D,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;wBACpB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC;qBAC3C,CAAC,CAAA;YACN,CAAC,CAAC;YACF,CAAC,CAAC,MAAM,CAAC,KAAK,CAAA;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IAC9E,CAAC,CAAA;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAE,EAAE,WAAW,CAAC,KAAK,CAAC,CAAA;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAE,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAE,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC1D,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9C,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IAC5E,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuC,CAAA;IAC7D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwC,CAAA;IAC/D,KAAK,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;QACpD,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAA;YACtB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;YACpB,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;gBAAE,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QACjG,CAAC;;YAAM,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IACjD,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC;QACxB,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,GAAI,CAAC;QAChC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CACpD,IAAI,KAAK,IAAI;YACX,CAAC,CAAC,MAAM,CAAC,IAAI,CACX,OAAO,CACL,UAAU,EACV,IAAI,kBAAkB,CAAC;gBACrB,OAAO,EAAE,kDAAkD,MAAM,GAAG;gBACpE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;aACvB,CAAC,CACH,CACF;YACD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CACnC,CAAC;QACF,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;QAC1C,IAAI;QACJ,KAAK;QACL,MAAM;QACN,MAAM;QACN,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC;QACjC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK;QAChD,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK;QACpD,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;YACtB,KAAK,CAAC,UAAU,GAAG,KAAK,CAAA;YACxB,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;YACnB,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;gBACtB,KAAK,CAAC,UAAU,GAAG,IAAI,CAAA;gBACvB,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAA;YACnB,CAAC,CAAC,CAAA;QACJ,CAAC,CAAC;KACH,CAAC,CAAA;IACF,IAAI,KAAK,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACpF,OAAO,MAAM,CAAA;AACf,CAAC,CAAC,CAAA","sourcesContent":["/**\n * Native I/O ownership for transient commands and prepared process owners.\n * @since 1.0.0\n */\n\nimport * as NodeSink from \"@effect/platform-node/NodeSink\"\nimport * as NodeStream from \"@effect/platform-node/NodeStream\"\nimport * as Effect from \"effect/Effect\"\nimport * as PlatformError from \"effect/PlatformError\"\nimport type * as Scope from \"effect/Scope\"\nimport * as Sink from \"effect/Sink\"\nimport * as Stream from \"effect/Stream\"\nimport * as ChildProcess from \"effect/unstable/process/ChildProcess\"\nimport { type ChildProcessHandle, ExitCode, makeHandle, ProcessId } from \"effect/unstable/process/ChildProcessSpawner\"\nimport * as Native from \"node:child_process\"\nimport { NativeProcessError } from \"./ProcessFault.ts\"\n\nconst ownerDescriptors = new WeakMap<ChildProcessHandle, ReadonlyArray<number | \"ignore\">>()\n\n/**\n * Windows owners receive caller streams above the reserved CRT standard slots.\n * @private\n * @since 1.0.0\n */\nexport const standardFdsOf = (handle: ChildProcessHandle): ReadonlyArray<number | \"ignore\"> | undefined =>\n  ownerDescriptors.get(handle)\n\nconst promise = <A>() => {\n  let resolve!: (value: A) => void\n  let reject!: (cause: unknown) => void\n  const promise = new Promise<A>((onSuccess, onFailure) => {\n    resolve = onSuccess\n    reject = onFailure\n  })\n  void promise.catch(() => {})\n  return { promise, resolve, reject }\n}\n\n/**\n * Converts native errors without losing their errno or signal.\n * @private\n * @since 1.0.0\n */\nexport const failure = (method: string, cause: unknown): PlatformError.PlatformError => {\n  const error = cause instanceof Error ? cause : new NativeProcessError({ message: String(cause) })\n  const code = (error as NodeJS.ErrnoException).code\n  return PlatformError.systemError({\n    _tag: code === \"ENOENT\" ? \"NotFound\" : code === \"EACCES\" || code === \"EPERM\" ? \"PermissionDenied\" : \"Unknown\",\n    module: \"ChildProcess\",\n    method,\n    description: error.message,\n    cause: error\n  })\n}\n\nconst inputConfig = (value: ChildProcess.CommandOptions[\"stdin\"]): ChildProcess.StdinConfig =>\n  value === undefined || typeof value === \"string\" || Stream.isStream(value)\n    ? { stream: value ?? \"pipe\" }\n    : value\n\nconst outputConfig = (\n  value: ChildProcess.CommandOptions[\"stdout\"]\n): ChildProcess.CommandOutput =>\n  value === undefined || typeof value === \"string\" || Sink.isSink(value)\n    ? value ?? \"pipe\"\n    : value.stream ?? \"pipe\"\n\nconst descriptorConfig = (options: ChildProcess.CommandOptions) => {\n  const stdin = inputConfig(options.stdin)\n  const stdout = outputConfig(options.stdout)\n  const stderr = outputConfig(options.stderr)\n  const additional: Array<{ readonly fd: number; readonly config: ChildProcess.AdditionalFdConfig }> = []\n  for (const [name, config] of Object.entries(options.additionalFds ?? {})) {\n    const fd = ChildProcess.parseFdName(name)\n    if (fd === undefined) continue\n    // A sparse descriptor declaration must not allocate an unbounded stdio\n    // table. The OS may impose a smaller limit when opening the actual pipes.\n    if (!Number.isSafeInteger(fd) || fd > 65_535) {\n      throw new RangeError(\"Additional file descriptors must be below 65536\")\n    }\n    additional.push({ fd, config })\n  }\n  additional.sort((left, right) => left.fd - right.fd)\n  const stdio: Array<Native.IOType> = Array.from(\n    { length: Math.max(2, ...additional.map(({ fd }) => fd)) + 1 },\n    () => \"ignore\"\n  )\n  stdio[0] = typeof stdin.stream === \"string\" ? stdin.stream : \"pipe\"\n  stdio[1] = typeof stdout === \"string\" ? stdout : \"pipe\"\n  stdio[2] = typeof stderr === \"string\" ? stderr : \"pipe\"\n  for (const { fd } of additional) stdio[fd] = \"pipe\"\n  return { stdin, stdout, stderr, additional, stdio }\n}\n\n/**\n * Native standard-command I/O, including configured streams and custom pipes.\n * Lifetime error listeners remain on every owned pipe after any consumer is\n * interrupted, so a pending native write cannot raise an unhandled late EPIPE.\n * Consumers still receive the original error through NodeStream/NodeSink.\n * This adapter also preserves native Windows verbatim arguments.\n *\n * It never sends a negative-pid signal. POSIX tree cleanup belongs to the\n * prepared supervisor, which remains alive while it signals its own group.\n * @private\n * @since 1.0.0\n */\nexport const spawn = (\n  command: ChildProcess.StandardCommand,\n  windowsVerbatimArguments: boolean | undefined,\n  owner = false\n): Effect.Effect<ChildProcessHandle, PlatformError.PlatformError, Scope.Scope> =>\n  Effect.gen(function*() {\n    const descriptors = yield* Effect.try({\n      try: () => descriptorConfig(command.options),\n      catch: (cause) => failure(\"spawn\", cause)\n    })\n    const standardFds: Array<number | \"ignore\"> = [0, 1, 2]\n    const physicalFds = [0, 1, 2]\n    const stdio: Array<Native.IOType | number> = [...descriptors.stdio]\n    if (owner && process.platform === \"win32\") {\n      const first = stdio.length\n      for (const fd of [0, 1, 2]) {\n        const mode = stdio[fd]!\n        physicalFds[fd] = first + fd\n        standardFds[fd] = mode === \"ignore\" ? \"ignore\" : first + fd\n        stdio.push(mode === \"inherit\" ? fd : mode)\n        stdio[fd] = \"ignore\"\n      }\n    }\n    const state = yield* Effect.acquireRelease(\n      Effect.try({\n        try: () => {\n          const ready = promise<void>()\n          // Startup errors reject ready before any handle is exposed. Once\n          // started, the native exit event or retained native status supplies\n          // this result.\n          let recordExit!: (result: readonly [number | null, NodeJS.Signals | null]) => void\n          const exited = new Promise<readonly [number | null, NodeJS.Signals | null]>((resolve) => {\n            recordExit = resolve\n          })\n          const options = command.options\n          const child = Native.spawn(command.command, [...command.args], {\n            cwd: options.cwd,\n            env: options.extendEnv ? { ...process.env, ...options.env } : options.env,\n            shell: options.shell,\n            detached: options.detached ?? process.platform !== \"win32\",\n            windowsHide: options.windowsHide ?? true,\n            windowsVerbatimArguments,\n            stdio\n          })\n          const state = {\n            child,\n            ready: ready.promise,\n            exited,\n            ended: false,\n            started: false,\n            referenced: true,\n            pipeErrors: new WeakMap<object, Error>(),\n            error: undefined as Error | undefined\n          }\n          child.once(\"spawn\", () => {\n            state.started = true\n            ready.resolve()\n          })\n          child.on(\"error\", (error) => {\n            state.error = error\n            if (!state.started) {\n              state.ended = true\n              ready.reject(error)\n            }\n          })\n          const onExit = (code: number | null, signal: NodeJS.Signals | null) => {\n            state.ended = true\n            recordExit([code, signal])\n          }\n          child.once(\"exit\", onExit)\n          // Bun can emit spawn before Native.spawn returns on a cold start.\n          // A returned pid proves that the native child was created; failed\n          // native spawns have no pid and still reject through the error event.\n          if (child.pid !== undefined) {\n            state.started = true\n            ready.resolve()\n          }\n          // Likewise retain an exit already reflected by the native handle\n          // before listeners could attach. Later events settle the same result.\n          if (child.exitCode != null || child.signalCode != null) {\n            onExit(child.exitCode ?? null, child.signalCode ?? null)\n          }\n          // A pipe can fail before a consumer has started reading or writing.\n          // Preserve the cause for consumers that attach after its error event.\n          for (const pipe of child.stdio) {\n            pipe?.on(\"error\", (error: Error) => {\n              state.pipeErrors.set(pipe, error)\n            })\n          }\n          // Node resumes unread stdio after exit to deliver its close event.\n          // A fast target can exit before activation returns the public handle;\n          // flowing at that point discards bytes before any consumer subscribes.\n          // Keep declared outputs in readable mode for their entire lifetime.\n          // This listener does not drain or copy data: the native high-water\n          // mark still applies backpressure until NodeStream pulls the bytes.\n          for (\n            const fd of [\n              physicalFds[1]!,\n              physicalFds[2]!,\n              ...descriptors.additional.filter(({ config }) => config.type === \"output\").map(({ fd }) => fd)\n            ]\n          ) {\n            const pipe = child.stdio[fd]\n            pipe?.on(\"readable\", () => {})\n            // POSIX sockets can close the unused writer independently. Bun\n            // needs this to retain buffered output after child exit. Windows\n            // named-pipe shutdown instead starts libuv's EOF timer, which can\n            // close both directions before the child writes. Leave it open.\n            if (process.platform !== \"win32\" && fd > 2 && pipe !== null && pipe !== undefined && \"end\" in pipe) {\n              pipe.end()\n            }\n          }\n          return state\n        },\n        catch: (cause) => failure(\"spawn\", cause)\n      }),\n      (state) =>\n        Effect.gen(function*() {\n          if (state.referenced && !state.ended) {\n            yield* Effect.try({\n              try: () => {\n                // Native kill returns false for an exit whose event is still\n                // queued. Require that event below; never infer a live failure\n                // or successful cleanup from the boolean alone.\n                if (!state.child.kill(\"SIGKILL\") && state.error !== undefined) throw state.error\n              },\n              catch: (cause) => failure(\"kill\", cause)\n            })\n            yield* Effect.promise(() => state.exited).pipe(\n              Effect.timeout(\"2 seconds\")\n            )\n          }\n        }).pipe(\n          Effect.ensuring(Effect.sync(() => {\n            for (const pipe of state.child.stdio) {\n              if (pipe !== null && pipe !== undefined && \"destroy\" in pipe && typeof pipe.destroy === \"function\") {\n                pipe.destroy()\n              }\n            }\n          })),\n          Effect.orDie\n        )\n    )\n    yield* Effect.tryPromise({ try: () => state.ready, catch: (cause) => failure(\"spawn\", cause) })\n    const wait = Effect.promise(() => state.exited)\n    const kill: ChildProcessHandle[\"kill\"] = (options) =>\n      Effect.suspend(() => {\n        if (state.ended) return Effect.void\n        const signal = options?.killSignal ?? command.options.killSignal ?? \"SIGTERM\"\n        const send = (signal: ChildProcess.Signal) =>\n          Effect.try({\n            try: () => {\n              if (!state.child.kill(signal) && state.error !== undefined) throw state.error\n            },\n            catch: (cause) => failure(\"kill\", cause)\n          })\n        return send(signal).pipe(\n          Effect.andThen(wait.pipe(Effect.timeoutOrElse({\n            duration: options?.forceKillAfter ?? command.options.forceKillAfter ?? 2000,\n            orElse: () => send(\"SIGKILL\").pipe(Effect.andThen(wait), Effect.timeout(\"2 seconds\"))\n          }))),\n          Effect.mapError((cause) => cause instanceof PlatformError.PlatformError ? cause : failure(\"kill\", cause)),\n          Effect.asVoid,\n          Effect.uninterruptible\n        )\n      })\n    const input = (fd: number, config?: ChildProcess.StdinConfig): ChildProcessHandle[\"stdin\"] => {\n      const pipe = state.child.stdio[fd]\n      if (pipe === null || pipe === undefined || !(\"write\" in pipe)) return Sink.drain\n      const writable = pipe\n      const method = fd === 0 ? \"stdin\" : `fd${fd}`\n      return Sink.suspend(() => {\n        const error = state.pipeErrors.get(pipe) ?? writable.errored ?? undefined\n        if (error !== undefined) return Sink.fail(failure(method, error))\n        if (writable.destroyed || writable.writableEnded) {\n          return Sink.fail(failure(method, new NativeProcessError({ message: `${method} is closed`, code: \"EPIPE\" })))\n        }\n        return NodeSink.fromWritable({\n          evaluate: () => writable,\n          onError: (cause) => failure(method, cause),\n          encoding: config?.encoding,\n          endOnDone: config?.endOnDone\n        })\n      })\n    }\n    const output = (fd: number, transform?: ChildProcess.CommandOutput): ChildProcessHandle[\"stdout\"] => {\n      const pipe = state.child.stdio[fd]\n      const stream = pipe !== null && pipe !== undefined && \"read\" in pipe\n        ? Stream.suspend(() => {\n          const method = fd === 1 ? \"stdout\" : fd === 2 ? \"stderr\" : `fd${fd}`\n          const error = state.pipeErrors.get(pipe) ?? pipe.errored ?? undefined\n          return error !== undefined ?\n            Stream.fail(failure(method, error)) :\n            NodeStream.fromReadable<Uint8Array, PlatformError.PlatformError>({\n              evaluate: () => pipe,\n              onError: (cause) => failure(method, cause)\n            })\n        })\n        : Stream.empty\n      return Sink.isSink(transform) ? Stream.transduce(stream, transform) : stream\n    }\n    const stdin = input(physicalFds[0]!, descriptors.stdin)\n    const stdout = output(physicalFds[1]!, descriptors.stdout)\n    const stderr = output(physicalFds[2]!, descriptors.stderr)\n    if (Stream.isStream(descriptors.stdin.stream)) {\n      yield* Stream.run(descriptors.stdin.stream, stdin).pipe(Effect.forkScoped)\n    }\n    const inputs = new Map<number, ChildProcessHandle[\"stdin\"]>()\n    const outputs = new Map<number, ChildProcessHandle[\"stdout\"]>()\n    for (const { fd, config } of descriptors.additional) {\n      if (config.type === \"input\") {\n        const sink = input(fd)\n        inputs.set(fd, sink)\n        if (config.stream !== undefined) yield* Stream.run(config.stream, sink).pipe(Effect.forkScoped)\n      } else outputs.set(fd, output(fd, config.sink))\n    }\n    const handle = makeHandle({\n      pid: ProcessId(state.child.pid!),\n      exitCode: wait.pipe(Effect.flatMap(([code, signal]) =>\n        code === null\n          ? Effect.fail(\n            failure(\n              \"exitCode\",\n              new NativeProcessError({\n                message: `Process interrupted due to receipt of signal: '${signal}'`,\n                signal: String(signal)\n              })\n            )\n          )\n          : Effect.succeed(ExitCode(code))\n      )),\n      isRunning: Effect.sync(() => !state.ended),\n      kill,\n      stdin,\n      stdout,\n      stderr,\n      all: Stream.merge(stdout, stderr),\n      getInputFd: (fd) => inputs.get(fd) ?? Sink.drain,\n      getOutputFd: (fd) => outputs.get(fd) ?? Stream.empty,\n      unref: Effect.sync(() => {\n        state.referenced = false\n        state.child.unref()\n        return Effect.sync(() => {\n          state.referenced = true\n          state.child.ref()\n        })\n      })\n    })\n    if (owner && process.platform === \"win32\") ownerDescriptors.set(handle, standardFds)\n    return handle\n  })\n"]}

package/dist/esm/internal/ProcSnapshot.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Process-group observation read from Linux `/proc`, with no `ps` binary.
+ * @since 1.0.0
+ */
+import type * as ProcessCleanup from "./ProcessCleanup.ts";
+/**
+ * The kernel's own process table, which is the production root.
+ * @private
+ * @since 1.0.0
+ */
+export declare const defaultProcRoot = "/proc";
+/**
+ * The `/proc` root a platform publishes its process table under, if any.
+ * @private
+ * @since 1.0.0-rc.1
+ */
+export declare const rootFor: (platform: string) => string | undefined;
+/**
+ * One process's group, zombie state and start time, from a `/proc/<pid>/stat`
+ * line.
+ *
+ * `comm` is the second field, it is wrapped in parentheses, and a process may
+ * put both spaces and parentheses inside it, so the numeric fields after it are
+ * taken from the LAST `)` rather than by splitting the whole line. The first
+ * field after that paren is field 3, so field N is at index N - 3.
+ *
+ * Anything that is not a stat line in that shape answers `undefined` rather
+ * than a record built out of whichever fields happened to parse.
+ * @private
+ * @since 1.0.0
+ */
+export declare const parseStat: (text: string, bootMs: number) => {
+    readonly pgid: number;
+    readonly member: ProcessCleanup.Member;
+} | undefined;
+/**
+ * Every member of `pgid`, plus this process's own group, read from `/proc`.
+ *
+ * Answering `undefined` means the question could not be asked here, which is
+ * what a non-Linux host and a `hidepid` mount both produce; the caller keeps
+ * its record rather than acting on a table it could not read. A pid that
+ * disappears between listing the directory and reading its `stat` is not an
+ * unreadable table: it is a process that ended, which is the same end state as
+ * never having been in the group, so it is skipped.
+ * @private
+ * @since 1.0.0
+ */
+export declare const snapshot: (root: string) => (pgid: number) => ProcessCleanup.Snapshot | undefined;
+/**
+ * This machine's boot instant from `${root}/stat`, in epoch milliseconds, or
+ * `undefined` when the table cannot be read here.
+ * @private
+ * @since 1.0.0
+ */
+export declare const bootMs: (root: string) => number | undefined;
+/**
+ * This process's own process group, read from `/proc/self/stat`, or `null`
+ * when the file cannot be read or parsed.
+ *
+ * The reaper's own-group guard needs this number before it may signal any
+ * group. Reading it here instead of from `ps` keeps the guard working on a
+ * Linux image that ships no `procps`.
+ * @private
+ * @since 1.0.0
+ */
+export declare const ownGroup: (root: string) => () => number | null;
+/**
+ * When `pid` started, in epoch milliseconds, read from `/proc/<pid>/stat` and
+ * `/proc/stat`'s `btime`.
+ *
+ * `gone` is the table having no entry for the pid (`ENOENT`). Every other
+ * failure is `unavailable`: the question could not be asked, so the caller
+ * keeps its record instead of acting on it.
+ * @private
+ * @since 1.0.0
+ */
+export declare const startedAtMs: (root: string) => (pid: number) => {
+    readonly _tag: "started";
+    readonly startedAtMs: number;
+} | {
+    readonly _tag: "gone";
+} | {
+    readonly _tag: "unavailable";
+};
+//# sourceMappingURL=ProcSnapshot.d.ts.map

package/dist/esm/internal/ProcSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcSnapshot.d.ts","sourceRoot":"","sources":["../../../src/internal/ProcSnapshot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,KAAK,cAAc,MAAM,qBAAqB,CAAA;AAE1D;;;;GAIG;AACH,eAAO,MAAM,eAAe,UAAU,CAAA;AAEtC;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,SAA+D,CAAA;AAoBnH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,GACpB,MAAM,MAAM,EACZ,QAAQ,MAAM,KACb;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,CAAA;CAAE,GAAG,SAoBtE,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,MAAM,MAAM,MAAM,KAAG,cAAc,CAAC,QAAQ,GAAG,SAgCnF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAS9C,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,WAAS,MAAM,GAAG,IAOtD,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,MAEtC,KAAK,MAAM,KAET;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAejC,CAAA"}

package/dist/esm/internal/ProcSnapshot.js

@@ -0,0 +1,188 @@
+/**
+ * Process-group observation read from Linux `/proc`, with no `ps` binary.
+ * @since 1.0.0
+ */
+import { readdirSync, readFileSync } from "node:fs";
+/**
+ * The kernel's own process table, which is the production root.
+ * @private
+ * @since 1.0.0
+ */
+export const defaultProcRoot = "/proc";
+/**
+ * The `/proc` root a platform publishes its process table under, if any.
+ * @private
+ * @since 1.0.0-rc.1
+ */
+export const rootFor = (platform) => platform === "linux" ? defaultProcRoot : undefined;
+/**
+ * `/proc` reports `starttime` in USER_HZ, which Linux fixes at 100 for this
+ * interface however the running kernel is configured.
+ */
+const userHz = 100;
+/** A pid, as both a directory name and the first field of a stat line. */
+const pidName = /^[0-9]+$/;
+/** `/proc/stat`'s boot instant, in seconds since the epoch. */
+const bootLine = /^btime[ \t]+([0-9]+)$/m;
+/** Fields 3 through 22 inclusive: state, then pgrp third, then starttime. */
+const statFieldsAfterComm = 20;
+/** A read that failed because the file is no longer there. */
+const missing = (cause) => cause.code === "ENOENT";
+/**
+ * One process's group, zombie state and start time, from a `/proc/<pid>/stat`
+ * line.
+ *
+ * `comm` is the second field, it is wrapped in parentheses, and a process may
+ * put both spaces and parentheses inside it, so the numeric fields after it are
+ * taken from the LAST `)` rather than by splitting the whole line. The first
+ * field after that paren is field 3, so field N is at index N - 3.
+ *
+ * Anything that is not a stat line in that shape answers `undefined` rather
+ * than a record built out of whichever fields happened to parse.
+ * @private
+ * @since 1.0.0
+ */
+export const parseStat = (text, bootMs) => {
+    const open = text.indexOf("(");
+    const close = text.lastIndexOf(")");
+    if (open <= 0 || close < open)
+        return undefined;
+    const head = text.slice(0, open).trim();
+    if (!pidName.test(head))
+        return undefined;
+    const after = text.slice(close + 1).trim().split(/[ \t]+/);
+    if (after.length < statFieldsAfterComm)
+        return undefined;
+    const pid = Number(head);
+    const pgid = Number(after[2]);
+    const startedTicks = Number(after[19]);
+    if (!Number.isSafeInteger(pid) || !Number.isSafeInteger(pgid) || !Number.isSafeInteger(startedTicks)) {
+        return undefined;
+    }
+    return {
+        pgid,
+        // A zombie holds a slot without being a process the caller has to wait for,
+        // so the distinction has to survive the read.
+        member: { pid, startedAtMs: bootMs + Math.round((startedTicks / userHz) * 1000), zombie: after[0] === "Z" }
+    };
+};
+/**
+ * Every member of `pgid`, plus this process's own group, read from `/proc`.
+ *
+ * Answering `undefined` means the question could not be asked here, which is
+ * what a non-Linux host and a `hidepid` mount both produce; the caller keeps
+ * its record rather than acting on a table it could not read. A pid that
+ * disappears between listing the directory and reading its `stat` is not an
+ * unreadable table: it is a process that ended, which is the same end state as
+ * never having been in the group, so it is skipped.
+ * @private
+ * @since 1.0.0
+ */
+export const snapshot = (root) => (pgid) => {
+    let bootMs;
+    let ownGroup;
+    let names;
+    try {
+        const boot = bootLine.exec(readFileSync(`${root}/stat`, "utf8"));
+        if (boot === null)
+            return undefined;
+        bootMs = Number(boot[1]) * 1000;
+        if (!Number.isSafeInteger(bootMs))
+            return undefined;
+        const self = parseStat(readFileSync(`${root}/self/stat`, "utf8"), bootMs);
+        if (self === undefined || self.pgid <= 0)
+            return undefined;
+        ownGroup = self.pgid;
+        names = readdirSync(root);
+    }
+    catch {
+        return undefined;
+    }
+    const members = [];
+    for (const name of names) {
+        if (!pidName.test(name))
+            continue;
+        let text;
+        try {
+            text = readFileSync(`${root}/${name}/stat`, "utf8");
+        }
+        catch (cause) {
+            if (missing(cause))
+                continue;
+            return undefined;
+        }
+        const parsed = parseStat(text, bootMs);
+        if (parsed === undefined)
+            return undefined;
+        if (parsed.pgid !== pgid)
+            continue;
+        members.push(parsed.member);
+    }
+    return { ownGroup, members };
+};
+/**
+ * This machine's boot instant from `${root}/stat`, in epoch milliseconds, or
+ * `undefined` when the table cannot be read here.
+ * @private
+ * @since 1.0.0
+ */
+export const bootMs = (root) => {
+    try {
+        const boot = bootLine.exec(readFileSync(`${root}/stat`, "utf8"));
+        if (boot === null)
+            return undefined;
+        const ms = Number(boot[1]) * 1000;
+        return Number.isSafeInteger(ms) ? ms : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * This process's own process group, read from `/proc/self/stat`, or `null`
+ * when the file cannot be read or parsed.
+ *
+ * The reaper's own-group guard needs this number before it may signal any
+ * group. Reading it here instead of from `ps` keeps the guard working on a
+ * Linux image that ships no `procps`.
+ * @private
+ * @since 1.0.0
+ */
+export const ownGroup = (root) => () => {
+    try {
+        const self = parseStat(readFileSync(`${root}/self/stat`, "utf8"), 0);
+        return self === undefined || self.pgid <= 0 ? null : self.pgid;
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * When `pid` started, in epoch milliseconds, read from `/proc/<pid>/stat` and
+ * `/proc/stat`'s `btime`.
+ *
+ * `gone` is the table having no entry for the pid (`ENOENT`). Every other
+ * failure is `unavailable`: the question could not be asked, so the caller
+ * keeps its record instead of acting on it.
+ * @private
+ * @since 1.0.0
+ */
+export const startedAtMs = (root) => (pid) => {
+    if (!Number.isSafeInteger(pid) || pid <= 0)
+        return { _tag: "unavailable" };
+    const boot = bootMs(root);
+    if (boot === undefined)
+        return { _tag: "unavailable" };
+    let text;
+    try {
+        text = readFileSync(`${root}/${pid}/stat`, "utf8");
+    }
+    catch (cause) {
+        return missing(cause) ? { _tag: "gone" } : { _tag: "unavailable" };
+    }
+    const parsed = parseStat(text, boot);
+    return parsed === undefined || parsed.member.pid !== pid
+        ? { _tag: "unavailable" }
+        : { _tag: "started", startedAtMs: parsed.member.startedAtMs };
+};
+//# sourceMappingURL=ProcSnapshot.js.map