fullnative 0.1.0

package/dist/core/process/Process.js

@@ -0,0 +1,138 @@
+import { Command } from "./Command.js";
+/**
+ * Facade para ejecutar y manejar procesos nativos con una API cómoda.
+ *
+ * @example
+ * const proc = new Process();
+ *
+ * // Ejecución simple
+ * const result = await proc.run("echo", "hola");
+ * console.log(result.stdout); // "hola\n"
+ *
+ * // Builder fluido
+ * const out = await proc.cmd("git")
+ *   .withArgs("log", "--oneline")
+ *   .in("/my/repo")
+ *   .output();
+ *
+ * // Proceso interactivo
+ * const p = proc.spawn("node", "-i");
+ * p.sendLine("1 + 1");
+ * p.endInput();
+ * await p.wait();
+ */
+export class Process {
+    /**
+     * Crea un builder de comando (`Command`) sin ejecutarlo.
+     *
+     * @param command - Comando a ejecutar.
+     * @param args - Argumentos del comando.
+     * @returns Un nuevo `Command` listo para configurar y ejecutar.
+     */
+    cmd(command, ...args) {
+        return new Command(command, args);
+    }
+    /**
+     * Ejecuta un comando, espera a que termine y devuelve el resultado.
+     *
+     * @param command - Comando a ejecutar.
+     * @param args - Argumentos del comando.
+     * @returns El `Result` de la ejecución.
+     */
+    async run(command, ...args) {
+        return new Command(command, args).run();
+    }
+    /**
+     * Ejecuta un comando y devuelve solo stdout, con espacios en blanco
+     * eliminados de los extremos (trim).
+     *
+     * @param command - Comando a ejecutar.
+     * @param args - Argumentos del comando.
+     * @returns El stdout del comando ya trimado.
+     */
+    async output(command, ...args) {
+        return (await this.run(command, ...args)).stdout.trim();
+    }
+    /**
+     * Ejecuta un script de shell interpretado por el shell del sistema
+     * (`/bin/sh` en Unix, `cmd.exe` en Windows) y espera a que termine.
+     *
+     * @param script - Script de shell a ejecutar.
+     * @param options - Opciones de ejecución del proceso.
+     * @returns El `Result` de la ejecución.
+     */
+    async shell(script, options = {}) {
+        const isWin = process.platform === "win32";
+        const shell = isWin ? "cmd.exe" : "/bin/sh";
+        const flag = isWin ? "/c" : "-c";
+        return new Command(shell, [flag, script], options).run();
+    }
+    /**
+     * Inicia un proceso y devuelve un `LiveProcess` para interactuar en vivo.
+     *
+     * @param command - Comando a ejecutar.
+     * @param args - Argumentos del comando.
+     * @returns Un `LiveProcess` que envuelve el proceso hijo recién iniciado.
+     */
+    spawn(command, ...args) {
+        return new Command(command, args).spawn();
+    }
+    /**
+     * Inicia un proceso con opciones de ejecución y devuelve un `LiveProcess`.
+     * La firma es *options-first*: las opciones se pasan antes que el comando.
+     *
+     * @param options - Opciones de ejecución del proceso.
+     * @param command - Comando a ejecutar.
+     * @param args - Argumentos del comando.
+     * @returns Un `LiveProcess` que envuelve el proceso hijo recién iniciado.
+     */
+    spawnWith(options, command, ...args) {
+        return new Command(command, args, options).spawn();
+    }
+    /**
+     * Ejecuta un script de shell interpretado por el shell del sistema
+     * (`/bin/sh` en Unix, `cmd.exe` en Windows) y devuelve un `LiveProcess`
+     * interactivo para comunicarse en vivo con el proceso.
+     *
+     * @param script - Script de shell a ejecutar.
+     * @param options - Opciones de ejecución del proceso.
+     * @returns Un `LiveProcess` que envuelve el proceso hijo recién iniciado.
+     */
+    spawnScript(script, options = {}) {
+        const isWin = process.platform === "win32";
+        const shell = isWin ? "cmd.exe" : "/bin/sh";
+        const flag = isWin ? "/c" : "-c";
+        return new Command(shell, [flag, script], options).spawn();
+    }
+    /**
+     * Comprueba si un comando existe en el PATH del sistema.
+     * Usa `where` en Windows y `which` en Unix.
+     *
+     * @param command - Nombre del comando a buscar.
+     * @returns `true` si el comando existe y es ejecutable, `false` en caso contrario.
+     */
+    async exists(command) {
+        const isWin = process.platform === "win32";
+        const check = isWin ? "where" : "which";
+        const result = await this.run(check, command);
+        return result.ok;
+    }
+    /**
+     * Devuelve la ruta completa del comando encontrado en el PATH, o `null`
+     * si no existe. Usa `where` en Windows y `which` en Unix; si hay múltiples
+     * resultados, devuelve el primero.
+     *
+     * @param command - Nombre del comando a buscar.
+     * @returns La ruta completa del comando, o `null` si no se encuentra.
+     */
+    async which(command) {
+        const isWin = process.platform === "win32";
+        const check = isWin ? "where" : "which";
+        const result = await this.run(check, command);
+        if (!result.ok)
+            return null;
+        const path = result.stdout.trim().split(/\r?\n/)[0];
+        return path || null;
+    }
+}
+//# sourceMappingURL=Process.js.map

package/dist/core/process/Process.js.map

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

package/dist/core/process/ProcessError.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Error estructurado para fallos de ejecución de procesos.
+ *
+ * Se lanza cuando un comando termina con código de salida != 0
+ * o cuando no se puede iniciar el proceso (ENOENT, EACCES, etc.).
+ *
+ * @example
+ * try {
+ *   await proc.run("nonexistent-cmd");
+ * } catch (err) {
+ *   if (err instanceof ProcessError) {
+ *     console.log(err.command);   // "nonexistent-cmd"
+ *     console.log(err.kind);      // "spawn" | "exit"
+ *     console.log(err.exitCode);  // null si fue spawn, number si fue exit
+ *   }
+ * }
+ */
+export declare class ProcessError extends Error {
+    /** Comando que originó el error. */
+    readonly command: string;
+    /** Argumentos pasados al comando. */
+    readonly args: readonly string[];
+    /**
+     * Tipo de fallo: `"spawn"` si el proceso no pudo iniciarse (p. ej. ENOENT,
+     * EACCES) o `"exit"` si terminó con código de salida distinto de 0.
+     */
+    readonly kind: "exit" | "spawn";
+    /** Código de salida del proceso; `null` si fue un fallo de spawn o terminó por señal. */
+    readonly exitCode: number | null;
+    /** Señal que terminó el proceso, o `null` si no fue por señal. */
+    readonly signal: NodeJS.Signals | null;
+    /** Salida de error (stderr) capturada, o cadena vacía si no hubo. */
+    readonly stderr: string;
+    /**
+     * Crea un `ProcessError`.
+     *
+     * @param command - Comando que originó el error.
+     * @param args - Argumentos pasados al comando.
+     * @param kind - Tipo de fallo: `"spawn"` o `"exit"`.
+     * @param options - Datos adicionales del fallo:
+     *   `exitCode`, `signal`, `stderr` y `cause` (error nativo original).
+     */
+    constructor(command: string, args: readonly string[], kind: "exit" | "spawn", options?: {
+        exitCode?: number | null;
+        signal?: NodeJS.Signals | null;
+        stderr?: string;
+        cause?: Error;
+    });
+}
+//# sourceMappingURL=ProcessError.d.ts.map

package/dist/core/process/ProcessError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessError.d.ts","sourceRoot":"","sources":["../../../src/core/process/ProcessError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACvC,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;;;;;OAQG;gBAED,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,EAAE,MAAM,GAAG,OAAO,EACtB,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,KAAK,CAAC;KACV;CAuBT"}

package/dist/core/process/ProcessError.js

@@ -0,0 +1,62 @@
+/**
+ * Error estructurado para fallos de ejecución de procesos.
+ *
+ * Se lanza cuando un comando termina con código de salida != 0
+ * o cuando no se puede iniciar el proceso (ENOENT, EACCES, etc.).
+ *
+ * @example
+ * try {
+ *   await proc.run("nonexistent-cmd");
+ * } catch (err) {
+ *   if (err instanceof ProcessError) {
+ *     console.log(err.command);   // "nonexistent-cmd"
+ *     console.log(err.kind);      // "spawn" | "exit"
+ *     console.log(err.exitCode);  // null si fue spawn, number si fue exit
+ *   }
+ * }
+ */
+export class ProcessError extends Error {
+    /** Comando que originó el error. */
+    command;
+    /** Argumentos pasados al comando. */
+    args;
+    /**
+     * Tipo de fallo: `"spawn"` si el proceso no pudo iniciarse (p. ej. ENOENT,
+     * EACCES) o `"exit"` si terminó con código de salida distinto de 0.
+     */
+    kind;
+    /** Código de salida del proceso; `null` si fue un fallo de spawn o terminó por señal. */
+    exitCode;
+    /** Señal que terminó el proceso, o `null` si no fue por señal. */
+    signal;
+    /** Salida de error (stderr) capturada, o cadena vacía si no hubo. */
+    stderr;
+    /**
+     * Crea un `ProcessError`.
+     *
+     * @param command - Comando que originó el error.
+     * @param args - Argumentos pasados al comando.
+     * @param kind - Tipo de fallo: `"spawn"` o `"exit"`.
+     * @param options - Datos adicionales del fallo:
+     *   `exitCode`, `signal`, `stderr` y `cause` (error nativo original).
+     */
+    constructor(command, args, kind, options = {}) {
+        const exitCode = options.exitCode ?? null;
+        const signal = options.signal ?? null;
+        const stderr = options.stderr ?? "";
+        const detail = kind === "spawn"
+            ? `failed to spawn: ${options.cause?.message ?? "unknown error"}`
+            : `exited with code ${exitCode}${signal ? ` (signal: ${signal})` : ""}`;
+        super(`Command "${command}" ${detail}${stderr ? `: ${stderr}` : ""}`, {
+            cause: options.cause,
+        });
+        this.name = "ProcessError";
+        this.command = command;
+        this.args = args;
+        this.kind = kind;
+        this.exitCode = exitCode;
+        this.signal = signal;
+        this.stderr = stderr;
+    }
+}
+//# sourceMappingURL=ProcessError.js.map

package/dist/core/process/ProcessError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessError.js","sourceRoot":"","sources":["../../../src/core/process/ProcessError.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,oCAAoC;IAC3B,OAAO,CAAS;IACzB,qCAAqC;IAC5B,IAAI,CAAoB;IACjC;;;OAGG;IACM,IAAI,CAAmB;IAChC,yFAAyF;IAChF,QAAQ,CAAgB;IACjC,kEAAkE;IACzD,MAAM,CAAwB;IACvC,qEAAqE;IAC5D,MAAM,CAAS;IAExB;;;;;;;;OAQG;IACH,YACE,OAAe,EACf,IAAuB,EACvB,IAAsB,EACtB,UAKI,EAAE;QAEN,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;QACtC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;QAEpC,MAAM,MAAM,GACV,IAAI,KAAK,OAAO;YACd,CAAC,CAAC,oBAAoB,OAAO,CAAC,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE;YACjE,CAAC,CAAC,oBAAoB,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAE5E,KAAK,CAAC,YAAY,OAAO,KAAK,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE;YACpE,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/core/process/Result.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Resultado inmutable de una ejecución de comando que ya terminó.
+ *
+ * Contiene toda la información de la ejecución: stdout, stderr, código de
+ * salida, señal recibida y duración. Proporciona métodos utilitarios para
+ * inspeccionar y transformar el resultado.
+ */
+export declare class Result {
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly exitCode: number | null;
+    readonly signal: NodeJS.Signals | null;
+    readonly durationMs: number;
+    /**
+     * Crea un nuevo resultado de ejecución.
+     *
+     * @param command - Comando ejecutado.
+     * @param args - Argumentos pasados al comando.
+     * @param stdout - Salida estándar capturada como texto.
+     * @param stderr - Salida de error capturada como texto.
+     * @param exitCode - Código de salida del proceso (`null` si fue terminado por señal).
+     * @param signal - Señal que terminó el proceso, o `null` si terminó naturalmente.
+     * @param durationMs - Duración total de la ejecución en milisegundos.
+     */
+    constructor(command: string, args: readonly string[], stdout: string, stderr: string, exitCode: number | null, signal: NodeJS.Signals | null, durationMs: number);
+    /** `true` si el proceso terminó con código de salida 0. */
+    get ok(): boolean;
+    /** `true` si el proceso terminó con código de salida distinto de 0. */
+    get failed(): boolean;
+    /**
+     * Combina stdout y stderr en un solo string, eliminando espacios
+     * en blanco al final.
+     */
+    get output(): string;
+    /**
+     * Devuelve las líneas de stdout separadas por saltos de línea (`\n` o
+     * `\r\n`), excluyendo las líneas vacías.
+     */
+    get lines(): string[];
+    /**
+     * Parsea stdout como JSON y lo devuelve como tipo `T`.
+     *
+     * **Nota:** Esta función realiza un *cast* sin verificación de tipos en
+     * tiempo de ejecución. La validez del tipo `T` es responsabilidad del
+     * llamador; si la salida no es JSON válido, `JSON.parse` lanzará un
+     * `SyntaxError`.
+     *
+     * @returns El JSON parseado, con tipo `T` (por defecto `unknown`).
+     */
+    json<T = unknown>(): T;
+    /**
+     * Lanza un `ProcessError` si el comando falló (código de salida != 0).
+     *
+     * @returns `this` si el comando fue exitoso, permitiendo encadenamiento.
+     * @throws {ProcessError} Cuando `failed` es `true`.
+     */
+    throwIfFailed(): this;
+}
+//# sourceMappingURL=Result.d.ts.map

package/dist/core/process/Result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Result.d.ts","sourceRoot":"","sources":["../../../src/core/process/Result.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,qBAAa,MAAM;aAaC,OAAO,EAAE,MAAM;aACf,IAAI,EAAE,SAAS,MAAM,EAAE;aACvB,MAAM,EAAE,MAAM;aACd,MAAM,EAAE,MAAM;aACd,QAAQ,EAAE,MAAM,GAAG,IAAI;aACvB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI;aAC7B,UAAU,EAAE,MAAM;IAlBpC;;;;;;;;;;OAUG;gBAEe,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,EAC7B,UAAU,EAAE,MAAM;IAGpC,2DAA2D;IAC3D,IAAI,EAAE,IAAI,OAAO,CAEhB;IAED,uEAAuE;IACvE,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;OAGG;IACH,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED;;;;;;;;;OASG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC;IAItB;;;;;OAKG;IACH,aAAa,IAAI,IAAI;CAUtB"}

package/dist/core/process/Result.js

@@ -0,0 +1,89 @@
+import { ProcessError } from "./ProcessError.js";
+/**
+ * Resultado inmutable de una ejecución de comando que ya terminó.
+ *
+ * Contiene toda la información de la ejecución: stdout, stderr, código de
+ * salida, señal recibida y duración. Proporciona métodos utilitarios para
+ * inspeccionar y transformar el resultado.
+ */
+export class Result {
+    command;
+    args;
+    stdout;
+    stderr;
+    exitCode;
+    signal;
+    durationMs;
+    /**
+     * Crea un nuevo resultado de ejecución.
+     *
+     * @param command - Comando ejecutado.
+     * @param args - Argumentos pasados al comando.
+     * @param stdout - Salida estándar capturada como texto.
+     * @param stderr - Salida de error capturada como texto.
+     * @param exitCode - Código de salida del proceso (`null` si fue terminado por señal).
+     * @param signal - Señal que terminó el proceso, o `null` si terminó naturalmente.
+     * @param durationMs - Duración total de la ejecución en milisegundos.
+     */
+    constructor(command, args, stdout, stderr, exitCode, signal, durationMs) {
+        this.command = command;
+        this.args = args;
+        this.stdout = stdout;
+        this.stderr = stderr;
+        this.exitCode = exitCode;
+        this.signal = signal;
+        this.durationMs = durationMs;
+    }
+    /** `true` si el proceso terminó con código de salida 0. */
+    get ok() {
+        return this.exitCode === 0;
+    }
+    /** `true` si el proceso terminó con código de salida distinto de 0. */
+    get failed() {
+        return !this.ok;
+    }
+    /**
+     * Combina stdout y stderr en un solo string, eliminando espacios
+     * en blanco al final.
+     */
+    get output() {
+        return (this.stdout + this.stderr).trimEnd();
+    }
+    /**
+     * Devuelve las líneas de stdout separadas por saltos de línea (`\n` o
+     * `\r\n`), excluyendo las líneas vacías.
+     */
+    get lines() {
+        return this.stdout.split(/\r?\n/).filter(Boolean);
+    }
+    /**
+     * Parsea stdout como JSON y lo devuelve como tipo `T`.
+     *
+     * **Nota:** Esta función realiza un *cast* sin verificación de tipos en
+     * tiempo de ejecución. La validez del tipo `T` es responsabilidad del
+     * llamador; si la salida no es JSON válido, `JSON.parse` lanzará un
+     * `SyntaxError`.
+     *
+     * @returns El JSON parseado, con tipo `T` (por defecto `unknown`).
+     */
+    json() {
+        return JSON.parse(this.stdout);
+    }
+    /**
+     * Lanza un `ProcessError` si el comando falló (código de salida != 0).
+     *
+     * @returns `this` si el comando fue exitoso, permitiendo encadenamiento.
+     * @throws {ProcessError} Cuando `failed` es `true`.
+     */
+    throwIfFailed() {
+        if (this.failed) {
+            throw new ProcessError(this.command, this.args, "exit", {
+                exitCode: this.exitCode,
+                signal: this.signal,
+                stderr: this.stderr,
+            });
+        }
+        return this;
+    }
+}
+//# sourceMappingURL=Result.js.map

package/dist/core/process/Result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Result.js","sourceRoot":"","sources":["../../../src/core/process/Result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,OAAO,MAAM;IAaC;IACA;IACA;IACA;IACA;IACA;IACA;IAlBlB;;;;;;;;;;OAUG;IACH,YACkB,OAAe,EACf,IAAuB,EACvB,MAAc,EACd,MAAc,EACd,QAAuB,EACvB,MAA6B,EAC7B,UAAkB;QANlB,YAAO,GAAP,OAAO,CAAQ;QACf,SAAI,GAAJ,IAAI,CAAmB;QACvB,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAe;QACvB,WAAM,GAAN,MAAM,CAAuB;QAC7B,eAAU,GAAV,UAAU,CAAQ;IACjC,CAAC;IAEJ,2DAA2D;IAC3D,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,uEAAuE;IACvE,IAAI,MAAM;QACR,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,IAAI,MAAM;QACR,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/C,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED;;;;;;;;;OASG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAM,CAAC;IACtC,CAAC;IAED;;;;;OAKG;IACH,aAAa;QACX,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE;gBACtD,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/core/process/index.d.ts

@@ -0,0 +1,7 @@
+export { Process } from "./Process.js";
+export { Command } from "./Command.js";
+export { LiveProcess } from "./LiveProcess.js";
+export { Result } from "./Result.js";
+export { ProcessError } from "./ProcessError.js";
+export type { ProcessOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/process/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/process/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/process/index.js

@@ -0,0 +1,6 @@
+export { Process } from "./Process.js";
+export { Command } from "./Command.js";
+export { LiveProcess } from "./LiveProcess.js";
+export { Result } from "./Result.js";
+export { ProcessError } from "./ProcessError.js";
+//# sourceMappingURL=index.js.map

package/dist/core/process/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/process/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/process/types.d.ts

@@ -0,0 +1,17 @@
+import type { SpawnOptions } from "node:child_process";
+/**
+ * Opciones para construir un comando antes de ejecutarlo.
+ *
+ * Extiende las opciones nativas de `child_process.spawn` con campos
+ * adicionales para controlar timeout, entrada por stdin y comportamiento
+ * ante códigos de salida distintos de cero.
+ */
+export interface ProcessOptions extends SpawnOptions {
+    /** Tiempo máximo de ejecución en ms antes de matar el proceso automáticamente. */
+    timeout?: number;
+    /** Datos a enviar por stdin al proceso al iniciar la ejecución. */
+    input?: string | Buffer;
+    /** Si es `true`, lanza un `ProcessError` cuando el código de salida no es 0. */
+    rejectOnNonZero?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/process/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/process/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,gFAAgF;IAChF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/dist/core/process/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/process/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/process/types.ts"],"names":[],"mappings":""}

package/dist/core/shell/Job.d.ts

@@ -0,0 +1,149 @@
+import { LiveProcess, type Result } from "../process/index.js";
+import type { JobOptions } from "./types.js";
+/**
+ * Representa un proceso en segundo plano registrado en una sesión de `Shell`.
+ *
+ * A diferencia de un `LiveProcess` suelto, un `Job` tiene:
+ * - **`name`**: identificador para referenciarlo desde `Shell.jobs`.
+ * - **`autoRestart`**: se reinicia solo si el proceso muere.
+ * - **Lifecycle atado a la sesión**: `Shell.killAll()` lo mata automáticamente.
+ *
+ * Expone toda la API de `LiveProcess` (stdin/stdout/kill/wait/onOutput/etc.)
+ * más la gestión de reinicio y nombre.
+ */
+export declare class Job {
+    /** Identificador del job en el registro de la sesión (`Shell.jobs`). */
+    readonly name: string;
+    /** El `LiveProcess` subyacente que el job envuelve. */
+    readonly process: LiveProcess;
+    /** Script original que se ejecuta (tras resolver aliases). */
+    readonly script: string;
+    /** Si el proceso muere, se reinicia automáticamente. */
+    readonly autoRestart: boolean;
+    private _restartCount;
+    private readonly _onRestart;
+    private _disposed;
+    /**
+     * Crea un nuevo job a partir de un `LiveProcess`.
+     *
+     * @param process - El `LiveProcess` a envolver.
+     * @param script - Script que se ejecuta (para reinicios).
+     * @param options - Opciones del job (`name`, `autoRestart`).
+     */
+    constructor(process: LiveProcess, script: string, options?: JobOptions);
+    /** PID del proceso subyacente, o `undefined` si aún no tiene. */
+    get pid(): number | undefined;
+    /** `true` si el proceso está en ejecución. */
+    get running(): boolean;
+    /** `true` si el proceso ya terminó. */
+    get ended(): boolean;
+    /** Código de salida del proceso (`null` si no terminó o fue por señal). */
+    get exitCode(): number | null;
+    /** `true` si el proceso fue detenido explícitamente (distingue kill vs salida natural). */
+    get stopped(): boolean;
+    /** Tiempo transcurrido desde el inicio, en milisegundos. */
+    get elapsed(): number;
+    /** Señal que terminó el proceso, o `null` si terminó naturalmente. */
+    get signal(): NodeJS.Signals | null;
+    /** Comando ejecutado. */
+    get command(): string;
+    /** Argumentos pasados al comando. */
+    get args(): readonly string[];
+    /** Fecha y hora de inicio del proceso. */
+    get startedAt(): Date;
+    /** Cantidad de veces que el job fue reiniciado vía `autoRestart`. */
+    get restartCount(): number;
+    /** Stream de entrada estándar del proceso. */
+    get stdin(): import("stream").Writable | null;
+    /** Stream de salida estándar del proceso. */
+    get stdout(): import("stream").Readable | null;
+    /** Stream de error estándar del proceso. */
+    get stderr(): import("stream").Readable | null;
+    /**
+     * Envía una señal al proceso y lo marca como dispuesto (no se reiniciará).
+     *
+     * @param signal - Señal a enviar (por defecto `SIGTERM`).
+     * @returns `true` si la señal fue entregada.
+     */
+    kill(signal?: NodeJS.Signals): boolean;
+    /**
+     * Fuerza la terminación del proceso (SIGKILL) y lo marca como dispuesto.
+     *
+     * @returns `true` si la señal fue entregada.
+     */
+    forceKill(): boolean;
+    /**
+     * Escribe datos al stdin del proceso.
+     *
+     * @param data - Datos a escribir (string o Buffer).
+     * @returns `true` si se escribió correctamente.
+     */
+    write(data: string | Buffer): boolean;
+    /**
+     * Escribe una línea al stdin del proceso (añade `\n`).
+     *
+     * @param line - Línea a escribir.
+     * @returns `true` si se escribió correctamente.
+     */
+    sendLine(line: string): boolean;
+    /** Cierra el stdin del proceso. */
+    endInput(): void;
+    /**
+     * Registra un callback para cada chunk de stdout.
+     *
+     * @param callback - Función a ejecutar con cada chunk.
+     * @returns `this` para encadenamiento.
+     */
+    onStdout(callback: (chunk: Buffer) => void): this;
+    /**
+     * Registra un callback para cada chunk de stderr.
+     *
+     * @param callback - Función a ejecutar con cada chunk.
+     * @returns `this` para encadenamiento.
+     */
+    onStderr(callback: (chunk: Buffer) => void): this;
+    /**
+     * Registra un callback para cada chunk de stdout o stderr (combinados).
+     *
+     * @param callback - Función a ejecutar con cada chunk.
+     * @returns `this` para encadenamiento.
+     */
+    onOutput(callback: (chunk: Buffer) => void): this;
+    /**
+     * Registra un callback que se ejecuta cuando el proceso termina.
+     *
+     * @param callback - Función a ejecutar con el resultado.
+     * @returns `this` para encadenamiento.
+     */
+    onExit(callback: (result: Result) => void): this;
+    /**
+     * Registra un callback que se ejecuta cuando el job se reinicia vía `autoRestart`.
+     *
+     * @param callback - Función a ejecutar con el job reiniciado.
+     * @returns `this` para encadenamiento.
+     */
+    onRestart(callback: (job: Job) => void): this;
+    /**
+     * Espera a que el proceso termine y devuelve el resultado.
+     *
+     * @returns El resultado de la ejecución.
+     */
+    wait(): Promise<Result>;
+    /**
+     * Alias de `wait()`. Espera a que el proceso termine y devuelve el resultado.
+     *
+     * @returns El resultado de la ejecución.
+     */
+    result(): Promise<Result>;
+    /**
+     * Reemplaza el `LiveProcess` subyacente (interno, usado por `Shell` para `autoRestart`).
+     * Incrementa `restartCount` y dispara los callbacks registrados en `onRestart`.
+     *
+     * @internal
+     * @param process - El nuevo `LiveProcess` que reemplaza al actual.
+     */
+    _replace(process: LiveProcess): void;
+    /** @internal Indica si el job fue dispuesto (no debe reiniciarse). */
+    get _disposed_(): boolean;
+}
+//# sourceMappingURL=Job.d.ts.map

package/dist/core/shell/Job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Job.d.ts","sourceRoot":"","sources":["../../../src/core/shell/Job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,qBAAa,GAAG;IACd,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;;;OAMG;gBAED,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,UAAe;IAQ1B,iEAAiE;IACjE,IAAI,GAAG,IAAI,MAAM,GAAG,SAAS,CAE5B;IAED,8CAA8C;IAC9C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,uCAAuC;IACvC,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,2EAA2E;IAC3E,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,2FAA2F;IAC3F,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,4DAA4D;IAC5D,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,sEAAsE;IACtE,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,GAAG,IAAI,CAElC;IAED,yBAAyB;IACzB,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,qCAAqC;IACrC,IAAI,IAAI,IAAI,SAAS,MAAM,EAAE,CAE5B;IAED,0CAA0C;IAC1C,IAAI,SAAS,IAAI,IAAI,CAEpB;IAED,qEAAqE;IACrE,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,8CAA8C;IAC9C,IAAI,KAAK,qCAER;IAED,6CAA6C;IAC7C,IAAI,MAAM,qCAET;IAED,4CAA4C;IAC5C,IAAI,MAAM,qCAET;IAED;;;;;OAKG;IACH,IAAI,CAAC,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,OAAO;IAKjD;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAKpB;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAIrC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,mCAAmC;IACnC,QAAQ,IAAI,IAAI;IAIhB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAKjD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAKjD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAKjD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAKhD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI;IAK7C;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAMpC,sEAAsE;IACtE,IAAI,UAAU,IAAI,OAAO,CAExB;CACF"}