@ac-kit/node 0.1.0

package/dist/net/tcp-socket.js

@@ -0,0 +1,153 @@
+import * as net from "node:net";
+import { composeInetAddress, } from "@ac-kit/core";
+import { StreamSocket } from "./stream-socket.js";
+/**
+ * TCP socket for establishing connections to TCP servers.
+ *
+ * Example usage:
+ *
+ * ```ts
+ * const tcpSocket = new TcpSocket.from();
+ * await tcpSocket.connect(80, "example.com");
+ * await tcpSocket.write("GET / HTTP/1.1\r\nHost: example.com\r\n\r\n");
+ * await tcpSocket.end({ waitForClose: true });
+ * ```
+ */
+export class TcpSocket extends StreamSocket {
+    /**
+     * Creates a new {@link TcpSocket} instance.
+     *
+     * @param options Options for creating the underlying Node.js socket.
+     * @returns A new `TcpSocket` instance.
+     */
+    static from(options) {
+        return new TcpSocket(new net.Socket(options));
+    }
+    constructor(sock) {
+        super(sock);
+        this.setupEventForwarding();
+    }
+    /**
+     * Returns the remote endpoint information of the socket.
+     *
+     * @throws {UnsupportedError} If the socket family is not IPv4 or IPv6.
+     */
+    get remoteEndpoint() {
+        const address = this.sock.remoteAddress;
+        const port = this.sock.remotePort;
+        const familyStr = this.sock.remoteFamily;
+        if (address === undefined ||
+            port === undefined ||
+            familyStr === undefined) {
+            return null;
+        }
+        return {
+            ...composeInetAddress(familyStr, address),
+            port,
+        };
+    }
+    /**
+     * Returns the local endpoint information of the socket.
+     *
+     * @throws {UnsupportedError} If the socket family is not IPv4 or IPv6.
+     */
+    get localEndpoint() {
+        const address = this.sock.localAddress;
+        const port = this.sock.localPort;
+        const familyStr = this.sock.localFamily;
+        if (address === undefined ||
+            port === undefined ||
+            familyStr === undefined) {
+            return null;
+        }
+        return {
+            ...composeInetAddress(familyStr, address),
+            port,
+        };
+    }
+    /**
+     * Sets the keep-alive option for the socket.
+     *
+     * @param enable Whether to enable keep-alive.
+     * @param initialDelay The initial delay in milliseconds before the first
+     *   keep-alive probe.
+     */
+    setKeepAlive(enable, initialDelay) {
+        this.sock.setKeepAlive(enable, initialDelay);
+    }
+    /**
+     * Disables the Nagle algorithm for the socket.
+     *
+     * @param noDelay Whether to disable the Nagle algorithm.
+     */
+    setNoDelay(noDelay) {
+        this.sock.setNoDelay(noDelay);
+    }
+    /**
+     * Establishes a TCP connection to the specified port and host.
+     *
+     * @param port The port to connect to.
+     * @param host The host to connect to (defaults to `localhost`).
+     * @param options Connection options.
+     * @returns A promise that resolves when the connection is successfully
+     *   established.
+     */
+    async connect(port, options) {
+        return new Promise((resolve, reject) => {
+            const { signal, ...connectOptions } = options ?? {};
+            signal?.throwIfAborted();
+            const handleError = (error) => {
+                this.handledErrorEvents.add(error);
+                signal?.removeEventListener("abort", handleAbort);
+                reject(error);
+            };
+            this.sock.prependOnceListener("error", handleError);
+            const handleAbort = () => {
+                this.sock.removeListener("error", handleError);
+                this.sock.destroy();
+                reject(signal?.reason);
+            };
+            signal?.addEventListener("abort", handleAbort, { once: true });
+            this.sock.connect({
+                ...connectOptions,
+                port,
+            }, () => {
+                this.sock.removeListener("error", handleError);
+                signal?.removeEventListener("abort", handleAbort);
+                resolve();
+            });
+        });
+    }
+    setupEventForwarding() {
+        super.setupEventForwarding();
+        this.sock.on("connectionAttempt", (ip, port, family) => {
+            this.dispatch("connectionAttempt", [
+                {
+                    ...composeInetAddress(family, ip),
+                    port,
+                },
+            ]);
+        });
+        this.sock.on("connectionAttemptFailed", (ip, port, family, error) => {
+            this.dispatch("connectionAttemptFailed", [
+                {
+                    ...composeInetAddress(family, ip),
+                    port,
+                },
+                error,
+            ]);
+        });
+        this.sock.on("connectionAttemptTimeout", (ip, port, family) => {
+            this.dispatch("connectionAttemptTimeout", [
+                {
+                    ...composeInetAddress(family, ip),
+                    port,
+                },
+            ]);
+        });
+        this.sock.on("lookup", (err, address, family, host) => {
+            this.dispatch("lookup", [err, composeInetAddress(family, address), host]);
+        });
+    }
+}
+//# sourceMappingURL=tcp-socket.js.map

package/dist/net/tcp-socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcp-socket.js","sourceRoot":"","sources":["../../src/net/tcp-socket.ts"],"names":[],"mappings":"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"}

package/dist/net/tls-socket.d.ts

@@ -0,0 +1,45 @@
+import type { X509Certificate } from "node:crypto";
+import type { Duplex } from "node:stream";
+import * as tls from "node:tls";
+import type { Except } from "type-fest";
+import type { StreamSocketEvents } from "./stream-socket.js";
+import { StreamSocket } from "./stream-socket.js";
+export type TlsSocketEvents = StreamSocketEvents & {
+    secureConnect: [];
+    ocspResponse: [response: Buffer | null];
+    keylog: [line: Buffer];
+    session: [session: Buffer];
+};
+export type TlsSocketOptions = Except<tls.TLSSocketOptions, "isServer" | "server" | keyof tls.SecureContextOptions>;
+export type TlsSocketConnectOptions = Except<tls.ConnectionOptions, "port"> & {
+    signal?: AbortSignal;
+};
+export declare class TlsSocket extends StreamSocket<tls.TLSSocket, TlsSocketEvents> {
+    static from(stream: Duplex, options?: TlsSocketOptions): TlsSocket;
+    static connect(port: number, options?: TlsSocketConnectOptions): Promise<TlsSocket>;
+    get encrypted(): boolean;
+    get authorized(): boolean;
+    get authorizationError(): Error | null;
+    get alpnProtocol(): string | null;
+    getCertificate(): tls.PeerCertificate | null;
+    getCipher(): tls.CipherNameAndProtocol;
+    getEphemeralKeyInfo(): tls.EphemeralKeyInfo | object | null;
+    getFinished(): Buffer | null;
+    getPeerCertificate<T extends boolean | undefined, R = T extends true ? tls.DetailedPeerCertificate : tls.PeerCertificate>(detailed?: T): R;
+    getPeerFinished(): Buffer | null;
+    getProtocol(): string | null;
+    getSession(): Buffer | null;
+    getSharedSigalgs(): string[];
+    getTicket(): Buffer | null;
+    isSessionReused(): boolean;
+    renegotiate(options: Parameters<tls.TLSSocket["renegotiate"]>[0]): Promise<void>;
+    setKeyCert(context: tls.SecureContext): void;
+    setMaxSendFragment(size: number): boolean;
+    disableRenegotiation(): void;
+    enableTrace(): void;
+    getPeerX509Certificate(): X509Certificate | null;
+    getX509Certificate(): X509Certificate | null;
+    exportKeyingMaterial(length: number, label: string, context: Buffer): Buffer;
+    protected setupEventForwarding(): void;
+}
+//# sourceMappingURL=tls-socket.d.ts.map

package/dist/net/tls-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tls-socket.d.ts","sourceRoot":"","sources":["../../src/net/tls-socket.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAGhC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAAG;IAClD,aAAa,EAAE,EAAE,CAAC;IAClB,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CACpC,GAAG,CAAC,gBAAgB,EACpB,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,CAAC,oBAAoB,CACtD,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG;IAC7E,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,qBAAa,SAAU,SAAQ,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC;IAC1E,OAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAE1E;IAED,MAAM,CAAC,OAAO,CACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,uBAAuB,GAC/B,OAAO,CAAC,SAAS,CAAC,CA8BpB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,kBAAkB,IAAI,KAAK,GAAG,IAAI,CAErC;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAGhC;IAED,cAAc,IAAI,GAAG,CAAC,eAAe,GAAG,IAAI,CAa3C;IAED,SAAS,IAAI,GAAG,CAAC,qBAAqB,CAErC;IAED,mBAAmB,IAAI,GAAG,CAAC,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAE1D;IAED,WAAW,IAAI,MAAM,GAAG,IAAI,CAG3B;IAED,kBAAkB,CACjB,CAAC,SAAS,OAAO,GAAG,SAAS,EAC7B,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,GAAG,CAAC,uBAAuB,GAAG,GAAG,CAAC,eAAe,EACrE,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAEjB;IAED,eAAe,IAAI,MAAM,GAAG,IAAI,CAG/B;IAED,WAAW,IAAI,MAAM,GAAG,IAAI,CAE3B;IAED,UAAU,IAAI,MAAM,GAAG,IAAI,CAG1B;IAED,gBAAgB,IAAI,MAAM,EAAE,CAE3B;IAED,SAAS,IAAI,MAAM,GAAG,IAAI,CAGzB;IAED,eAAe,IAAI,OAAO,CAEzB;IAEK,WAAW,CAChB,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC,CAiBf;IAED,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,aAAa,GAAG,IAAI,CAE3C;IAED,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExC;IAED,oBAAoB,IAAI,IAAI,CAE3B;IAED,WAAW,IAAI,IAAI,CAElB;IAED,sBAAsB,IAAI,eAAe,GAAG,IAAI,CAG/C;IAED,kBAAkB,IAAI,eAAe,GAAG,IAAI,CAG3C;IAED,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3E;IAED,UAAmB,oBAAoB,IAAI,IAAI,CAkB9C;CACD"}

package/dist/net/tls-socket.js

@@ -0,0 +1,148 @@
+import * as tls from "node:tls";
+import { isObject } from "@ac-kit/core";
+import { StreamSocket } from "./stream-socket.js";
+export class TlsSocket extends StreamSocket {
+    static from(stream, options) {
+        return new TlsSocket(new tls.TLSSocket(stream, options));
+    }
+    static connect(port, options) {
+        return new Promise((resolve, reject) => {
+            const { signal, ...connectOptions } = options ?? {};
+            signal?.throwIfAborted();
+            const tlsSocket = new TlsSocket(tls.connect({ ...connectOptions, port }));
+            const handleError = (error) => {
+                tlsSocket.unsubscribe("secureConnect", handleSecureConnect);
+                signal?.removeEventListener("abort", handleAbort);
+                reject(error);
+            };
+            tlsSocket.subscribe("error", handleError, { once: true });
+            const handleSecureConnect = () => {
+                tlsSocket.unsubscribe("error", handleError);
+                signal?.removeEventListener("abort", handleAbort);
+                resolve(tlsSocket);
+            };
+            tlsSocket.subscribe("secureConnect", handleSecureConnect, { once: true });
+            const handleAbort = () => {
+                tlsSocket.unsubscribe("error", handleError);
+                tlsSocket.unsubscribe("secureConnect", handleSecureConnect);
+                tlsSocket.destroy();
+                reject(signal?.reason);
+            };
+            signal?.addEventListener("abort", handleAbort, { once: true });
+        });
+    }
+    get encrypted() {
+        return this.sock.encrypted;
+    }
+    get authorized() {
+        return this.sock.authorized;
+    }
+    get authorizationError() {
+        return this.sock.authorizationError ?? null;
+    }
+    get alpnProtocol() {
+        const value = this.sock.alpnProtocol;
+        return value === false ? null : value;
+    }
+    getCertificate() {
+        const cert = this.sock.getCertificate();
+        // Connection established but no certificate presented
+        if (isObject(cert) && Object.keys(cert).length === 0) {
+            return null;
+        }
+        if (cert === null) {
+            return null;
+        }
+        return cert;
+    }
+    getCipher() {
+        return this.sock.getCipher();
+    }
+    getEphemeralKeyInfo() {
+        return this.sock.getEphemeralKeyInfo();
+    }
+    getFinished() {
+        const value = this.sock.getFinished();
+        return value ?? null;
+    }
+    getPeerCertificate(detailed) {
+        return this.sock.getPeerCertificate(detailed);
+    }
+    getPeerFinished() {
+        const value = this.sock.getPeerFinished();
+        return value ?? null;
+    }
+    getProtocol() {
+        return this.sock.getProtocol();
+    }
+    getSession() {
+        const value = this.sock.getSession();
+        return value ?? null;
+    }
+    getSharedSigalgs() {
+        return this.sock.getSharedSigalgs();
+    }
+    getTicket() {
+        const value = this.sock.getTLSTicket();
+        return value ?? null;
+    }
+    isSessionReused() {
+        return this.sock.isSessionReused();
+    }
+    async renegotiate(options) {
+        // renegotiate callback is never called if socket is destroyed
+        if (this.sock.destroyed) {
+            throw new Error("Socket is destroyed");
+        }
+        return new Promise((resolve, reject) => {
+            const callback = (err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            };
+            this.sock.renegotiate(options, callback);
+        });
+    }
+    setKeyCert(context) {
+        this.sock.setKeyCert(context);
+    }
+    setMaxSendFragment(size) {
+        return this.sock.setMaxSendFragment(size);
+    }
+    disableRenegotiation() {
+        this.sock.disableRenegotiation();
+    }
+    enableTrace() {
+        this.sock.enableTrace();
+    }
+    getPeerX509Certificate() {
+        const cert = this.sock.getPeerX509Certificate();
+        return cert ?? null;
+    }
+    getX509Certificate() {
+        const cert = this.sock.getX509Certificate();
+        return cert ?? null;
+    }
+    exportKeyingMaterial(length, label, context) {
+        return this.sock.exportKeyingMaterial(length, label, context);
+    }
+    setupEventForwarding() {
+        super.setupEventForwarding();
+        this.sock.on("secureConnect", () => {
+            this.dispatch("secureConnect", []);
+        });
+        this.sock.on("OCSPResponse", (response) => {
+            this.dispatch("ocspResponse", [response]);
+        });
+        this.sock.on("keylog", (line) => {
+            this.dispatch("keylog", [line]);
+        });
+        this.sock.on("session", (session) => {
+            this.dispatch("session", [session]);
+        });
+    }
+}
+//# sourceMappingURL=tls-socket.js.map

package/dist/net/tls-socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tls-socket.js","sourceRoot":"","sources":["../../src/net/tls-socket.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAIxC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAkBlD,MAAM,OAAO,SAAU,SAAQ,YAA4C;IAC1E,MAAM,CAAU,IAAI,CAAC,MAAc,EAAE,OAA0B;QAC9D,OAAO,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,OAAO,CACb,IAAY,EACZ,OAAiC;QAEjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;YAEpD,MAAM,EAAE,cAAc,EAAE,CAAC;YAEzB,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAE1E,MAAM,WAAW,GAAG,CAAC,KAAY,EAAE,EAAE;gBACpC,SAAS,CAAC,WAAW,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;gBAC5D,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBAClD,MAAM,CAAC,KAAK,CAAC,CAAC;YACf,CAAC,CAAC;YACF,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAE1D,MAAM,mBAAmB,GAAG,GAAG,EAAE;gBAChC,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBAC5C,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBAClD,OAAO,CAAC,SAAS,CAAC,CAAC;YACpB,CAAC,CAAC;YACF,SAAS,CAAC,SAAS,CAAC,eAAe,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAE1E,MAAM,WAAW,GAAG,GAAG,EAAE;gBACxB,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBAC5C,SAAS,CAAC,WAAW,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;gBAC5D,SAAS,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACxB,CAAC,CAAC;YACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;IAC5B,CAAC;IAED,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;IAC7B,CAAC;IAED,IAAI,kBAAkB;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC;IAC7C,CAAC;IAED,IAAI,YAAY;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;QACrC,OAAO,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACvC,CAAC;IAED,cAAc;QACb,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QAExC,sDAAsD;QACtD,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,OAAO,IAAI,CAAC;QACb,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACb,CAAC;QAED,OAAO,IAA2B,CAAC;IACpC,CAAC;IAED,SAAS;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;IAC9B,CAAC;IAED,mBAAmB;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACxC,CAAC;IAED,WAAW;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACtC,OAAO,KAAK,IAAI,IAAI,CAAC;IACtB,CAAC;IAED,kBAAkB,CAGhB,QAAY;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAM,CAAC;IACpD,CAAC;IAED,eAAe;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,OAAO,KAAK,IAAI,IAAI,CAAC;IACtB,CAAC;IAED,WAAW;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC;IAED,UAAU;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrC,OAAO,KAAK,IAAI,IAAI,CAAC;IACtB,CAAC;IAED,gBAAgB;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACrC,CAAC;IAED,SAAS;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACvC,OAAO,KAAK,IAAI,IAAI,CAAC;IACtB,CAAC;IAED,eAAe;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,WAAW,CAChB,OAAoD;QAEpD,8DAA8D;QAC9D,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,QAAQ,GAAG,CAAC,GAA6B,EAAE,EAAE;gBAClD,IAAI,GAAG,EAAE,CAAC;oBACT,MAAM,CAAC,GAAG,CAAC,CAAC;gBACb,CAAC;qBAAM,CAAC;oBACP,OAAO,EAAE,CAAC;gBACX,CAAC;YACF,CAAC,CAAC;YAEF,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,UAAU,CAAC,OAA0B;QACpC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,kBAAkB,CAAC,IAAY;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,oBAAoB;QACnB,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAClC,CAAC;IAED,WAAW;QACV,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACzB,CAAC;IAED,sBAAsB;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAChD,OAAO,IAAI,IAAI,IAAI,CAAC;IACrB,CAAC;IAED,kBAAkB;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5C,OAAO,IAAI,IAAI,IAAI,CAAC;IACrB,CAAC;IAED,oBAAoB,CAAC,MAAc,EAAE,KAAa,EAAE,OAAe;QAClE,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAEkB,oBAAoB;QACtC,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAE7B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,GAAG,EAAE;YAClC,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,EAAE;YACzC,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/B,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACJ,CAAC;CACD"}

package/dist/process/fork-process.d.ts

@@ -0,0 +1,63 @@
+import { type ChildProcess, type Serializable } from "node:child_process";
+import { Callable } from "@ac-kit/core";
+import { type ProcessOutputStream, SpawnedProcess, type SpawnedProcessEvents, type SpawnedProcessOptions } from "./spawned-process.js";
+import type { ProcessStdio } from "./start-process.js";
+export type ForkedProcessEvents = SpawnedProcessEvents & {
+    /** A message the child sent over the IPC channel. */
+    message: [message: unknown];
+};
+export type ForkProcessOptions = {
+    readonly args?: readonly string[] | null;
+    readonly cwd?: string | null;
+    readonly env?: NodeJS.ProcessEnv | null;
+    readonly execArgv?: readonly string[] | null;
+    /** Default `"advanced"` — structured clone, so Uint8Array/BigInt survive. */
+    readonly serialization?: "json" | "advanced" | null;
+    /** Aborting terminates the child (SIGTERM, then SIGKILL after `graceMs`). */
+    readonly signal?: AbortSignal | null;
+    /**
+     * Default `"inherit"`, or `"pipe"` when `onOutput` is given. `output` events
+     * only ever carry a piped stream. IPC uses its own fd, so nothing the child
+     * prints can corrupt it.
+     */
+    readonly stdout?: ProcessStdio | null;
+    /** Default `"inherit"`, or `"pipe"` when `onOutput` is given. */
+    readonly stderr?: ProcessStdio | null;
+    /** Pre-subscribed before the child can write anything. */
+    readonly onOutput?: Callable<[
+        stream: ProcessOutputStream,
+        line: string
+    ]> | null;
+    /** Pre-subscribed before the child can send anything. */
+    readonly onMessage?: Callable<[message: unknown]> | null;
+    /** Default 5000. */
+    readonly graceMs?: number | null;
+};
+/**
+ * A forked Node module: everything a {@link SpawnedProcess} offers, plus the IPC
+ * channel `fork` opens.
+ */
+export declare class ForkedProcess extends SpawnedProcess<ForkedProcessEvents> {
+    constructor(child: ChildProcess, startedAt: number, options?: SpawnedProcessOptions);
+    /**
+     * Sends a message to the child.
+     *
+     * @param message Anything the configured serialization can carry.
+     * @param signal Abandons the send.
+     * @returns A promise resolving once the message has been handed to the OS.
+     */
+    send(message: Serializable, signal?: AbortSignal | null): Promise<void>;
+}
+/**
+ * Forks a Node module with an IPC channel and resolves once it has spawned, so
+ * the returned handle always has a `pid` and a live channel. A spawn failure
+ * rejects here rather than surfacing later on the handle.
+ *
+ * @param modulePath The module to run as the child.
+ * @param options Streams, environment, cancellation. See
+ *   {@link ForkProcessOptions}.
+ * @returns A handle over the running child.
+ * @throws When the module cannot be forked.
+ */
+export declare function forkProcess(modulePath: string, options?: ForkProcessOptions): Promise<ForkedProcess>;
+//# sourceMappingURL=fork-process.d.ts.map

package/dist/process/fork-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-process.d.ts","sourceRoot":"","sources":["../../src/process/fork-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAQ,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EACN,KAAK,mBAAmB,EACxB,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,GAAG;IACxD,qDAAqD;IACrD,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAEzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;IAExC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAE7C,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAEpD,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAErC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAEtC,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAEtC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAC3B;QAAC,MAAM,EAAE,mBAAmB;QAAE,IAAI,EAAE,MAAM;KAAC,CAC3C,GAAG,IAAI,CAAC;IAET,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAEzD,oBAAoB;IACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,qBAAa,aAAc,SAAQ,cAAc,CAAC,mBAAmB,CAAC;IACrE,YACC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qBAAqB,EAQ/B;IAED;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBtE;CACD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAoDxB"}

package/dist/process/fork-process.js

@@ -0,0 +1,98 @@
+import { fork } from "node:child_process";
+import { SpawnedProcess, } from "./spawned-process.js";
+/**
+ * A forked Node module: everything a {@link SpawnedProcess} offers, plus the IPC
+ * channel `fork` opens.
+ */
+export class ForkedProcess extends SpawnedProcess {
+    constructor(child, startedAt, options) {
+        super(child, startedAt, options);
+        // Eager, unlike `output`: an unread IPC channel drops what arrives on it.
+        child.on("message", (message) => {
+            this.dispatch("message", [message]);
+        });
+    }
+    /**
+     * Sends a message to the child.
+     *
+     * @param message Anything the configured serialization can carry.
+     * @param signal Abandons the send.
+     * @returns A promise resolving once the message has been handed to the OS.
+     */
+    send(message, signal) {
+        if (signal?.aborted === true) {
+            return Promise.reject(signal.reason);
+        }
+        return new Promise((resolve, reject) => {
+            const onAbort = () => reject(signal?.reason);
+            signal?.addEventListener("abort", onAbort, { once: true });
+            this.child.send(message, (error) => {
+                signal?.removeEventListener("abort", onAbort);
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve();
+            });
+        });
+    }
+}
+/**
+ * Forks a Node module with an IPC channel and resolves once it has spawned, so
+ * the returned handle always has a `pid` and a live channel. A spawn failure
+ * rejects here rather than surfacing later on the handle.
+ *
+ * @param modulePath The module to run as the child.
+ * @param options Streams, environment, cancellation. See
+ *   {@link ForkProcessOptions}.
+ * @returns A handle over the running child.
+ * @throws When the module cannot be forked.
+ */
+export async function forkProcess(modulePath, options) {
+    const startedAt = performance.now();
+    const piped = options?.onOutput ? "pipe" : "inherit";
+    const child = fork(modulePath, options?.args ? [...options.args] : [], {
+        cwd: options?.cwd ?? undefined,
+        env: options?.env ?? undefined,
+        execArgv: options?.execArgv ? [...options.execArgv] : undefined,
+        serialization: options?.serialization ?? "advanced",
+        stdio: [
+            "inherit",
+            options?.stdout ?? piped,
+            options?.stderr ?? piped,
+            "ipc",
+        ],
+    });
+    // Attached before anything can await: an abort signal fires 'error' on the
+    // next tick, which would go unhandled during the gap below.
+    child.on("error", () => { });
+    await new Promise((resolve, reject) => {
+        child.once("error", reject);
+        child.once("spawn", () => {
+            child.removeListener("error", reject);
+            resolve();
+        });
+    });
+    const forked = new ForkedProcess(child, startedAt, {
+        graceMs: options?.graceMs,
+    });
+    const onMessage = options?.onMessage;
+    if (onMessage) {
+        forked.subscribe("message", onMessage);
+    }
+    const onOutput = options?.onOutput;
+    if (onOutput) {
+        forked.subscribe("output", onOutput);
+    }
+    const signal = options?.signal;
+    if (signal?.aborted === true) {
+        void forked.terminate();
+    }
+    else {
+        signal?.addEventListener("abort", () => void forked.terminate(), {
+            once: true,
+        });
+    }
+    return forked;
+}
+//# sourceMappingURL=fork-process.js.map

package/dist/process/fork-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-process.js","sourceRoot":"","sources":["../../src/process/fork-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,IAAI,EAAqB,MAAM,oBAAoB,CAAC;AAIhF,OAAO,EAEN,cAAc,GAGd,MAAM,sBAAsB,CAAC;AA6C9B;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAmC;IACrE,YACC,KAAmB,EACnB,SAAiB,EACjB,OAA+B;QAE/B,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAEjC,0EAA0E;QAC1E,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YAC/B,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,OAAqB,EAAE,MAA2B;QACtD,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC7C,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAE3D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBAClC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC9C,IAAI,KAAK,EAAE,CAAC;oBACX,MAAM,CAAC,KAAK,CAAC,CAAC;oBACd,OAAO;gBACR,CAAC;gBACD,OAAO,EAAE,CAAC;YACX,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC;CACD;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,UAAkB,EAClB,OAA4B;IAE5B,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAErD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE;QACtE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,SAAS;QAC9B,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,SAAS;QAC9B,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;QAC/D,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,UAAU;QACnD,KAAK,EAAE;YACN,SAAS;YACT,OAAO,EAAE,MAAM,IAAI,KAAK;YACxB,OAAO,EAAE,MAAM,IAAI,KAAK;YACxB,KAAK;SACL;KACD,CAAC,CAAC;IAEH,2EAA2E;IAC3E,4DAA4D;IAC5D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAE5B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACxB,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACtC,OAAO,EAAE,CAAC;QACX,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE;QAClD,OAAO,EAAE,OAAO,EAAE,OAAO;KACzB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;IACrC,IAAI,SAAS,EAAE,CAAC;QACf,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;IACnC,IAAI,QAAQ,EAAE,CAAC;QACd,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;IAC/B,IAAI,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;IACzB,CAAC;SAAM,CAAC;QACP,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,SAAS,EAAE,EAAE;YAChE,IAAI,EAAE,IAAI;SACV,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/process/guarded.d.ts

@@ -0,0 +1,12 @@
+import { MaybePromiseLike } from "@ac-kit/core";
+/**
+ * Runs `work`, converting a process-level crash (a synchronous throw outside
+ * any promise chain — a stray socket/timer callback, for instance) into a
+ * rejection of the returned promise instead of letting it kill the process.
+ *
+ * @param work The function to run.
+ * @returns A promise settling the same way `work` would have, had its crash
+ *   been catchable normally.
+ */
+export declare function rejectOnUncaught<T>(work: () => MaybePromiseLike<T>): Promise<T>;
+//# sourceMappingURL=guarded.d.ts.map

package/dist/process/guarded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guarded.d.ts","sourceRoot":"","sources":["../../src/process/guarded.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,gBAAgB,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CAiBZ"}

package/dist/process/guarded.js

@@ -0,0 +1,25 @@
+/**
+ * Runs `work`, converting a process-level crash (a synchronous throw outside
+ * any promise chain — a stray socket/timer callback, for instance) into a
+ * rejection of the returned promise instead of letting it kill the process.
+ *
+ * @param work The function to run.
+ * @returns A promise settling the same way `work` would have, had its crash
+ *   been catchable normally.
+ */
+export function rejectOnUncaught(work) {
+    return new Promise((resolve, reject) => {
+        const onCrash = (error) => reject(error);
+        process.once("uncaughtException", onCrash);
+        Promise.resolve()
+            .then(work)
+            .then((value) => {
+            process.off("uncaughtException", onCrash);
+            resolve(value);
+        }, (error) => {
+            process.off("uncaughtException", onCrash);
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=guarded.js.map

package/dist/process/guarded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guarded.js","sourceRoot":"","sources":["../../src/process/guarded.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC/B,IAA+B;IAE/B,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACzC,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,CAAC,OAAO,EAAE;aACf,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,CACJ,CAAC,KAAK,EAAE,EAAE;YACT,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;YAC1C,OAAO,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YAClB,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;YAC1C,MAAM,CAAC,KAAc,CAAC,CAAC;QACxB,CAAC,CACD,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/process/spawn-process.d.ts

@@ -0,0 +1,37 @@
+import { type StartProcessOptions } from "./start-process.js";
+/** Which of the child's streams are buffered into a {@link ProcessResult}. */
+export type ProcessCapture = "both" | "stdout" | "stderr" | "none";
+export type SpawnProcessOptions = StartProcessOptions & {
+    /** Default `"utf8"`. */
+    readonly encoding?: BufferEncoding | null;
+    /** Per-stream cap on what is buffered. Default 8 MiB. */
+    readonly maxBuffer?: number | null;
+    /** Default `"both"`. */
+    readonly capture?: ProcessCapture | null;
+    /** Throw on a non-zero exit code or a terminating signal. Default `true`. */
+    readonly throwOnNonZero?: boolean | null;
+};
+export type ProcessResult = {
+    code: number | null;
+    signal: NodeJS.Signals | null;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+};
+/**
+ * Runs a command to completion and returns what it printed.
+ *
+ * The one-shot form of {@link startProcess}: no handle is exposed, so streaming
+ * consumers pass `onOutput` instead of subscribing.
+ *
+ * @param command The executable to run.
+ * @param args Arguments passed to it verbatim.
+ * @param options Capture limits and everything {@link StartProcessOptions}
+ *   accepts.
+ * @returns The exit status and the captured streams.
+ * @throws {ProcessExitWithOutputError} On a non-zero exit, unless
+ *   `throwOnNonZero` is `false`.
+ * @throws {RangeError} When either stream exceeds `maxBuffer`.
+ */
+export declare function spawnProcess(command: string, args?: readonly string[], options?: SpawnProcessOptions): Promise<ProcessResult>;
+//# sourceMappingURL=spawn-process.d.ts.map

package/dist/process/spawn-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-process.d.ts","sourceRoot":"","sources":["../../src/process/spawn-process.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,mBAAmB,EAAgB,MAAM,oBAAoB,CAAC;AAE5E,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnE,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG;IACvD,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAE1C,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,wBAAwB;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAEzC,6EAA6E;IAC7E,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CACjC,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA4ExB"}