fullnative 0.1.0

package/dist/core/shell/Job.js

@@ -0,0 +1,218 @@
+/**
+ * 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 class Job {
+    /** Identificador del job en el registro de la sesión (`Shell.jobs`). */
+    name;
+    /** El `LiveProcess` subyacente que el job envuelve. */
+    process;
+    /** Script original que se ejecuta (tras resolver aliases). */
+    script;
+    /** Si el proceso muere, se reinicia automáticamente. */
+    autoRestart;
+    _restartCount = 0;
+    _onRestart = new Set();
+    _disposed = false;
+    /**
+     * 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, script, options = {}) {
+        this.name = options.name ?? `job-${process.pid ?? Date.now()}`;
+        this.process = process;
+        this.script = script;
+        this.autoRestart = options.autoRestart ?? false;
+    }
+    /** PID del proceso subyacente, o `undefined` si aún no tiene. */
+    get pid() {
+        return this.process.pid;
+    }
+    /** `true` si el proceso está en ejecución. */
+    get running() {
+        return this.process.running;
+    }
+    /** `true` si el proceso ya terminó. */
+    get ended() {
+        return this.process.ended;
+    }
+    /** Código de salida del proceso (`null` si no terminó o fue por señal). */
+    get exitCode() {
+        return this.process.exitCode;
+    }
+    /** `true` si el proceso fue detenido explícitamente (distingue kill vs salida natural). */
+    get stopped() {
+        return this.process.stopped;
+    }
+    /** Tiempo transcurrido desde el inicio, en milisegundos. */
+    get elapsed() {
+        return this.process.elapsed;
+    }
+    /** Señal que terminó el proceso, o `null` si terminó naturalmente. */
+    get signal() {
+        return this.process.signal;
+    }
+    /** Comando ejecutado. */
+    get command() {
+        return this.process.command;
+    }
+    /** Argumentos pasados al comando. */
+    get args() {
+        return this.process.args;
+    }
+    /** Fecha y hora de inicio del proceso. */
+    get startedAt() {
+        return this.process.startedAt;
+    }
+    /** Cantidad de veces que el job fue reiniciado vía `autoRestart`. */
+    get restartCount() {
+        return this._restartCount;
+    }
+    /** Stream de entrada estándar del proceso. */
+    get stdin() {
+        return this.process.stdin;
+    }
+    /** Stream de salida estándar del proceso. */
+    get stdout() {
+        return this.process.stdout;
+    }
+    /** Stream de error estándar del proceso. */
+    get stderr() {
+        return this.process.stderr;
+    }
+    /**
+     * 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 = "SIGTERM") {
+        this._disposed = true;
+        return this.process.kill(signal);
+    }
+    /**
+     * Fuerza la terminación del proceso (SIGKILL) y lo marca como dispuesto.
+     *
+     * @returns `true` si la señal fue entregada.
+     */
+    forceKill() {
+        this._disposed = true;
+        return this.process.forceKill();
+    }
+    /**
+     * Escribe datos al stdin del proceso.
+     *
+     * @param data - Datos a escribir (string o Buffer).
+     * @returns `true` si se escribió correctamente.
+     */
+    write(data) {
+        return this.process.write(data);
+    }
+    /**
+     * 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) {
+        return this.process.sendLine(line);
+    }
+    /** Cierra el stdin del proceso. */
+    endInput() {
+        this.process.endInput();
+    }
+    /**
+     * Registra un callback para cada chunk de stdout.
+     *
+     * @param callback - Función a ejecutar con cada chunk.
+     * @returns `this` para encadenamiento.
+     */
+    onStdout(callback) {
+        this.process.onStdout(callback);
+        return this;
+    }
+    /**
+     * Registra un callback para cada chunk de stderr.
+     *
+     * @param callback - Función a ejecutar con cada chunk.
+     * @returns `this` para encadenamiento.
+     */
+    onStderr(callback) {
+        this.process.onStderr(callback);
+        return 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) {
+        this.process.onOutput(callback);
+        return 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) {
+        this.process.onExit(callback);
+        return 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) {
+        this._onRestart.add(callback);
+        return this;
+    }
+    /**
+     * Espera a que el proceso termine y devuelve el resultado.
+     *
+     * @returns El resultado de la ejecución.
+     */
+    async wait() {
+        return this.process.wait();
+    }
+    /**
+     * Alias de `wait()`. Espera a que el proceso termine y devuelve el resultado.
+     *
+     * @returns El resultado de la ejecución.
+     */
+    async result() {
+        return this.wait();
+    }
+    /**
+     * 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) {
+        this.process = process;
+        this._restartCount++;
+        for (const cb of this._onRestart)
+            cb(this);
+    }
+    /** @internal Indica si el job fue dispuesto (no debe reiniciarse). */
+    get _disposed_() {
+        return this._disposed;
+    }
+}
+//# sourceMappingURL=Job.js.map

package/dist/core/shell/Job.js.map

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

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

@@ -0,0 +1,275 @@
+import { LiveProcess, type Result, type ProcessOptions } from "../process/index.js";
+import { Job } from "./Job.js";
+import type { ShellConfig, HistoryItem, JobOptions } from "./types.js";
+/**
+ * Facade que representa una sesión de shell para ejecutar comandos
+ * de forma cómoda. Mantiene estado (cwd, env, aliases, historial) y
+ * delega la ejecución a `Process` por debajo.
+ *
+ * @example
+ * const sh = new Shell();
+ *
+ * // Ejecución simple (shell-interpreted)
+ * const result = await sh.run("echo hola && ls -la");
+ * console.log(result.stdout);
+ *
+ * // Tagged template con interpolación segura
+ * const name = "mundo";
+ * await sh.$`echo hola ${name}`;
+ *
+ * // Pipeline
+ * const r = await sh.pipe("cat file.txt", "grep foo", "wc -l");
+ *
+ * // Cadena secuencial (stop on error)
+ * const results = await sh.chain("npm install", "npm run build", "npm test");
+ *
+ * // Segundo plano
+ * const job = sh.bg("npm run dev");
+ * job.onStdout(chunk => process.stdout.write(chunk));
+ * const res = await job.result();
+ */
+export declare class Shell {
+    private readonly _proc;
+    private _cwd;
+    private _env;
+    private _aliases;
+    private _history;
+    private _jobs;
+    private _cleanupRegistered;
+    /**
+     * Crea una nueva sesión de shell.
+     *
+     * @param options - Configuración de la sesión (cwd, env, shell).
+     */
+    constructor(options?: ShellConfig);
+    /** Directorio de trabajo actual de la sesión. */
+    get cwd(): string;
+    /** Copia de las variables de entorno de la sesión. */
+    get env(): Record<string, string>;
+    /** Copia de los alias definidos como objeto plano. */
+    get aliases(): Record<string, string>;
+    /** Historial de comandos ejecutados (solo lectura). */
+    get history(): readonly HistoryItem[];
+    /**
+     * Cambia el directorio de trabajo de la sesión.
+     *
+     * @param path - Ruta del nuevo directorio de trabajo.
+     * @returns `this` para encadenamiento.
+     */
+    cd(path: string): this;
+    /**
+     * Establece una variable de entorno para los próximos comandos.
+     *
+     * @param key - Nombre de la variable.
+     * @param value - Valor de la variable.
+     * @returns `this` para encadenamiento.
+     */
+    set(key: string, value: string): this;
+    /**
+     * Elimina una variable de entorno de la sesión.
+     *
+     * @param key - Nombre de la variable a eliminar.
+     * @returns `this` para encadenamiento.
+     */
+    unset(key: string): this;
+    /**
+     * Define un alias para un comando.
+     *
+     * @param name - Nombre del alias.
+     * @param command - Comando al que se expande el alias.
+     * @returns `this` para encadenamiento.
+     */
+    alias(name: string, command: string): this;
+    /**
+     * Elimina un alias.
+     *
+     * @param name - Nombre del alias a eliminar.
+     * @returns `this` para encadenamiento.
+     */
+    unalias(name: string): this;
+    /**
+     * Tagged template que ejecuta un comando interpolando valores
+     * de forma segura (con quoting automático). Lanza `TypeError` si algún
+     * valor interpolado no es de un tipo soportado (string, number, boolean,
+     * array, null/undefined).
+     *
+     * @example
+     * const name = "world";
+     * await sh.$`echo hello ${name}`;
+     * // ejecuta: echo hello 'world'
+     *
+     * const files = ["a.txt", "b.txt"];
+     * await sh.$`cat ${files}`;
+     * // ejecuta: cat 'a.txt' 'b.txt'
+     *
+     * @param strings - Partes literales del template.
+     * @param values - Valores interpolados (se quotean automáticamente).
+     * @returns El resultado de la ejecución.
+     * @throws {TypeError} Cuando un valor interpolado no se puede quotear.
+     */
+    $(strings: TemplateStringsArray, ...values: unknown[]): Promise<Result>;
+    /**
+     * Ejecuta un script shell (interpretado), espera a que termine y devuelve el resultado.
+     *
+     * @param script - Script a ejecutar.
+     * @param options - Opciones adicionales de proceso (sobrescriben cwd/env de la sesión).
+     * @returns El resultado de la ejecución.
+     */
+    run(script: string, options?: ProcessOptions): Promise<Result>;
+    /**
+     * Inicia un script shell (interpretado) y devuelve un `LiveProcess`
+     * para interactuar en vivo con su stdin/stdout/stderr.
+     *
+     * @param script - Script a iniciar.
+     * @returns El `LiveProcess` del script lanzado.
+     */
+    spawnScript(script: string): LiveProcess;
+    /**
+     * Ejecuta una serie de comandos en pipeline (stdout de uno al stdin del siguiente).
+     * Devuelve el resultado del último comando. Lanza `TypeError` si no se pasa
+     * ningún comando.
+     *
+     * @example
+     * const r = await sh.pipe("cat file.txt", "grep foo", "wc -l");
+     *
+     * @param scripts - Comandos a ejecutar en pipeline.
+     * @returns El resultado del último comando del pipeline.
+     * @throws {TypeError} Cuando `scripts` está vacío.
+     */
+    pipe(...scripts: string[]): Promise<Result>;
+    /**
+     * Ejecuta comandos secuencialmente. Se detiene al primer fallo
+     * y devuelve todos los resultados hasta ese punto.
+     *
+     * @example
+     * const results = await sh.chain("npm install", "npm run build", "npm test");
+     *
+     * @param scripts - Comandos a ejecutar en secuencia.
+     * @returns Resultados de cada comando ejecutado (hasta el primer fallo).
+     */
+    chain(...scripts: string[]): Promise<Result[]>;
+    /**
+     * Ejecuta `condition`; si termina OK, ejecuta `then`.
+     *
+     * @param condition - Comando condicional a evaluar.
+     * @param then - Comando a ejecutar si `condition` termina OK.
+     * @returns El resultado del segundo comando o `null` si no se ejecutó.
+     */
+    ifOk(condition: string, then: string): Promise<Result | null>;
+    /**
+     * Ejecuta `condition`; si termina con error, ejecuta `then`.
+     *
+     * @param condition - Comando condicional a evaluar.
+     * @param then - Comando a ejecutar si `condition` falla.
+     * @returns El resultado del segundo comando o `null` si no se ejecutó.
+     */
+    ifFail(condition: string, then: string): Promise<Result | null>;
+    /**
+     * Inicia un script en segundo plano y devuelve un `Job` registrado
+     * en la sesión con el `name` dado (o uno aleatorio) y la opción `autoRestart`.
+     * El job se elimina del registro automáticamente al terminar (si no se reinicia).
+     * Lanza `TypeError` si ya existe un job con el mismo nombre.
+     *
+     * @example
+     * const dev = sh.bg("npm run dev", { name: "dev" });
+     * dev.onOutput(chunk => process.stdout.write(chunk));
+     *
+     * // Más tarde
+     * sh.killAll();
+     *
+     * @example autoRestart
+     * const server = sh.bg("npm run serve", { name: "server", autoRestart: true });
+     * server.onRestart(job => console.log(`Restarted (${job.restartCount})`));
+     *
+     * @param script - Script a ejecutar en segundo plano.
+     * @param options - Opciones del job (`name`, `autoRestart`).
+     * @returns El `Job` registrado en la sesión.
+     * @throws {TypeError} Cuando ya existe un job con el `name` dado.
+     */
+    bg(script: string, options?: JobOptions): Job;
+    /** Mapa de jobs activos en la sesión, indexados por nombre (solo lectura). */
+    get jobs(): ReadonlyMap<string, Job>;
+    /** Lista de jobs actualmente en ejecución. */
+    get activeJobs(): readonly Job[];
+    /**
+     * Mata todos los jobs activos con la señal dada (por defecto `SIGTERM`).
+     *
+     * @param signal - Señal a enviar a cada job activo.
+     */
+    killAll(signal?: NodeJS.Signals): void;
+    /**
+     * Devuelve un job por nombre.
+     *
+     * @param name - Nombre del job a buscar.
+     * @returns El `Job` correspondiente, o `undefined` si no existe.
+     */
+    job(name: string): Job | undefined;
+    /**
+     * Comprueba si un comando existe en el PATH.
+     *
+     * @param command - Comando a buscar.
+     * @returns `true` si el comando existe.
+     */
+    exists(command: string): Promise<boolean>;
+    /**
+     * Devuelve la ruta completa del comando o `null` si no existe.
+     *
+     * @param command - Comando a resolver.
+     * @returns La ruta absoluta del comando, o `null` si no se encuentra.
+     */
+    which(command: string): Promise<string | null>;
+    /** Limpia el historial de comandos. */
+    clearHistory(): void;
+    /**
+     * Devuelve la última entrada del historial.
+     *
+     * @returns La última `HistoryItem`, o `undefined` si el historial está vacío.
+     */
+    lastCommand(): HistoryItem | undefined;
+    /**
+     * Construye las `ProcessOptions` base incluyendo `cwd` y `env` de la sesión.
+     *
+     * @param extra - Opciones adicionales que sobrescriben las de la sesión.
+     * @returns Las opciones de proceso combinadas.
+     */
+    private buildOptions;
+    /**
+     * Resuelve aliases en la primera palabra del script.
+     *
+     * @param script - Script original.
+     * @returns El script con el alias expandido (si aplica).
+     */
+    private resolveAliases;
+    /**
+     * Escapa un valor para interpolación segura en shell. Lanza `TypeError`
+     * si el valor es de un tipo no soportado (p. ej. objetos).
+     *
+     * @param value - Valor a quotear (string, number, boolean, array, null/undefined).
+     * @returns El valor quoteado como string seguro para shell.
+     * @throws {TypeError} Cuando el valor es de un tipo no soportado (p. ej. object).
+     */
+    private quote;
+    /**
+     * Registra una entrada en el historial.
+     *
+     * @param command - Comando ejecutado.
+     * @param startMs - Timestamp de inicio (ms desde epoch).
+     * @param result - Resultado de la ejecución.
+     */
+    private recordHistory;
+    /**
+     * Configura el watcher de `autoRestart` sobre un job: cuando el proceso
+     * termina (sin ser dispuesto), se lanza un reemplazo y se registra
+     * recursivamente para el siguiente reinicio.
+     *
+     * @param job - Job a vigilar.
+     * @param script - Script a re-ejecutar al reiniciar.
+     */
+    private watchAutoRestart;
+    /**
+     * Registra handlers de proceso (`exit`, `SIGINT`, `SIGTERM`) para matar
+     * los jobs huérfanos al salir. Solo se registra una vez por sesión.
+     */
+    private ensureCleanup;
+}
+//# sourceMappingURL=Shell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Shell.d.ts","sourceRoot":"","sources":["../../../src/core/shell/Shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EACX,KAAK,MAAM,EACX,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGvE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,kBAAkB,CAAS;IAEnC;;;;OAIG;gBACS,OAAO,GAAE,WAAgB;IAQrC,iDAAiD;IACjD,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,sDAAsD;IACtD,IAAI,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEhC;IAED,sDAAsD;IACtD,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEpC;IAED,uDAAuD;IACvD,IAAI,OAAO,IAAI,SAAS,WAAW,EAAE,CAEpC;IAID;;;;;OAKG;IACH,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKtB;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAKrC;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKxB;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAK1C;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO3B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,CAAC,CACC,OAAO,EAAE,oBAAoB,EAC7B,GAAG,MAAM,EAAE,OAAO,EAAE,GACnB,OAAO,CAAC,MAAM,CAAC;IAWlB;;;;;;OAMG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAUpE;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;IAMxC;;;;;;;;;;;OAWG;IACG,IAAI,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBjD;;;;;;;;;OASG;IACG,KAAK,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUpD;;;;;;OAMG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMnE;;;;;;OAMG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQrE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,GAAG;IA6B7C,8EAA8E;IAC9E,IAAI,IAAI,IAAI,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAEnC;IAED,8CAA8C;IAC9C,IAAI,UAAU,IAAI,SAAS,GAAG,EAAE,CAE/B;IAED;;;;OAIG;IACH,OAAO,CAAC,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,IAAI;IAMjD;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS;IAMlC;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/C;;;;;OAKG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMpD,uCAAuC;IACvC,YAAY,IAAI,IAAI;IAIpB;;;;OAIG;IACH,WAAW,IAAI,WAAW,GAAG,SAAS;IAMtC;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IActB;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK;IAcb;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAcrB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IASxB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAetB"}