fullnative 0.1.0

package/dist/core/shell/Shell.js

@@ -0,0 +1,461 @@
+import { Process, } from "../process/index.js";
+import { Job } from "./Job.js";
+import * as crypto from "node:crypto";
+/**
+ * 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 class Shell {
+    _proc;
+    _cwd;
+    _env;
+    _aliases = new Map();
+    _history = [];
+    _jobs = new Map();
+    _cleanupRegistered = false;
+    /**
+     * Crea una nueva sesión de shell.
+     *
+     * @param options - Configuración de la sesión (cwd, env, shell).
+     */
+    constructor(options = {}) {
+        this._proc = new Process();
+        this._cwd = options.cwd ?? process.cwd();
+        this._env = options.env ?? {};
+    }
+    // ─── Getters ─────────────────────────────────────────────────────
+    /** Directorio de trabajo actual de la sesión. */
+    get cwd() {
+        return this._cwd;
+    }
+    /** Copia de las variables de entorno de la sesión. */
+    get env() {
+        return { ...this._env };
+    }
+    /** Copia de los alias definidos como objeto plano. */
+    get aliases() {
+        return Object.fromEntries(this._aliases);
+    }
+    /** Historial de comandos ejecutados (solo lectura). */
+    get history() {
+        return this._history;
+    }
+    // ─── State management ────────────────────────────────────────────
+    /**
+     * Cambia el directorio de trabajo de la sesión.
+     *
+     * @param path - Ruta del nuevo directorio de trabajo.
+     * @returns `this` para encadenamiento.
+     */
+    cd(path) {
+        this._cwd = path;
+        return 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, value) {
+        this._env[key] = value;
+        return this;
+    }
+    /**
+     * Elimina una variable de entorno de la sesión.
+     *
+     * @param key - Nombre de la variable a eliminar.
+     * @returns `this` para encadenamiento.
+     */
+    unset(key) {
+        delete this._env[key];
+        return 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, command) {
+        this._aliases.set(name, command);
+        return this;
+    }
+    /**
+     * Elimina un alias.
+     *
+     * @param name - Nombre del alias a eliminar.
+     * @returns `this` para encadenamiento.
+     */
+    unalias(name) {
+        this._aliases.delete(name);
+        return this;
+    }
+    // ─── Execution (delegates to Process) ─────────────────────────────
+    /**
+     * 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, ...values) {
+        let script = "";
+        for (let i = 0; i < strings.length; i++) {
+            script += strings[i];
+            if (i < values.length) {
+                script += this.quote(values[i]);
+            }
+        }
+        return this.run(script);
+    }
+    /**
+     * 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.
+     */
+    async run(script, options) {
+        const resolved = this.resolveAliases(script);
+        const start = Date.now();
+        const result = await this._proc.shell(resolved, this.buildOptions(options));
+        this.recordHistory(script, start, result);
+        return result;
+    }
+    // ─── Process management (delegates to Process) ────────────────────
+    /**
+     * 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) {
+        return this._proc.spawnScript(this.resolveAliases(script), this.buildOptions());
+    }
+    // ─── Composition ─────────────────────────────────────────────────
+    /**
+     * 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.
+     */
+    async pipe(...scripts) {
+        if (scripts.length === 0) {
+            throw new TypeError("pipe requires at least one command");
+        }
+        if (scripts.length === 1)
+            return this.run(scripts[0]);
+        const handles = scripts.map((s) => this._proc.spawnScript(this.resolveAliases(s), this.buildOptions()));
+        for (let i = 0; i < handles.length - 1; i++) {
+            handles[i].stdout?.pipe(handles[i + 1].stdin);
+        }
+        const results = await Promise.all(handles.map((h) => h.wait()));
+        return results[results.length - 1];
+    }
+    /**
+     * 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).
+     */
+    async chain(...scripts) {
+        const results = [];
+        for (const script of scripts) {
+            const result = await this.run(script);
+            results.push(result);
+            if (result.failed)
+                break;
+        }
+        return results;
+    }
+    /**
+     * 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ó.
+     */
+    async ifOk(condition, then) {
+        const result = await this.run(condition);
+        if (result.ok)
+            return this.run(then);
+        return 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ó.
+     */
+    async ifFail(condition, then) {
+        const result = await this.run(condition);
+        if (result.failed)
+            return this.run(then);
+        return null;
+    }
+    // ─── Background jobs ─────────────────────────────────────────────
+    /**
+     * 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, options) {
+        const name = options?.name ?? crypto.randomUUID();
+        if (this._jobs.has(name)) {
+            throw new TypeError(`Job "${name}" already exists`);
+        }
+        const live = this.spawnScript(script);
+        const job = new Job(live, this.resolveAliases(script), { name, ...options });
+        this._jobs.set(name, job);
+        this.ensureCleanup();
+        job.onExit(() => {
+            if (job.ended && !job._disposed_) {
+                this._jobs.delete(name);
+            }
+        });
+        if (job.autoRestart && !job.ended) {
+            job.onExit(() => {
+                if (job._disposed_)
+                    return;
+                const replacement = this.spawnScript(script);
+                job._replace(replacement);
+                this.watchAutoRestart(job, script);
+            });
+        }
+        return job;
+    }
+    /** Mapa de jobs activos en la sesión, indexados por nombre (solo lectura). */
+    get jobs() {
+        return this._jobs;
+    }
+    /** Lista de jobs actualmente en ejecución. */
+    get activeJobs() {
+        return [...this._jobs.values()].filter((j) => j.running);
+    }
+    /**
+     * 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 = "SIGTERM") {
+        for (const job of this._jobs.values()) {
+            if (job.running)
+                job.kill(signal);
+        }
+    }
+    /**
+     * Devuelve un job por nombre.
+     *
+     * @param name - Nombre del job a buscar.
+     * @returns El `Job` correspondiente, o `undefined` si no existe.
+     */
+    job(name) {
+        return this._jobs.get(name);
+    }
+    // ─── Utilities (delegates to Process) ────────────────────────────
+    /**
+     * Comprueba si un comando existe en el PATH.
+     *
+     * @param command - Comando a buscar.
+     * @returns `true` si el comando existe.
+     */
+    async exists(command) {
+        return this._proc.exists(command);
+    }
+    /**
+     * 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.
+     */
+    async which(command) {
+        return this._proc.which(command);
+    }
+    // ─── History ──────────────────────────────────────────────────────
+    /** Limpia el historial de comandos. */
+    clearHistory() {
+        this._history = [];
+    }
+    /**
+     * Devuelve la última entrada del historial.
+     *
+     * @returns La última `HistoryItem`, o `undefined` si el historial está vacío.
+     */
+    lastCommand() {
+        return this._history[this._history.length - 1];
+    }
+    // ─── Private helpers ─────────────────────────────────────────────
+    /**
+     * 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.
+     */
+    buildOptions(extra) {
+        return {
+            cwd: this._cwd,
+            env: { ...process.env, ...this._env },
+            ...extra,
+        };
+    }
+    /**
+     * Resuelve aliases en la primera palabra del script.
+     *
+     * @param script - Script original.
+     * @returns El script con el alias expandido (si aplica).
+     */
+    resolveAliases(script) {
+        const trimmed = script.trimStart();
+        const firstSpace = trimmed.indexOf(" ");
+        const firstWord = firstSpace === -1 ? trimmed : trimmed.slice(0, firstSpace);
+        if (this._aliases.has(firstWord)) {
+            const replacement = this._aliases.get(firstWord);
+            if (firstSpace === -1)
+                return replacement;
+            return replacement + trimmed.slice(firstSpace);
+        }
+        return script;
+    }
+    /**
+     * 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).
+     */
+    quote(value) {
+        if (value === null || value === undefined)
+            return "''";
+        if (typeof value === "number" || typeof value === "boolean") {
+            return String(value);
+        }
+        if (Array.isArray(value)) {
+            return value.map((v) => this.quote(v)).join(" ");
+        }
+        if (typeof value === "string") {
+            return `'${value.replace(/'/g, "'\\''")}'`;
+        }
+        throw new TypeError(`Cannot quote value of type ${typeof value}`);
+    }
+    /**
+     * 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.
+     */
+    recordHistory(command, startMs, result) {
+        this._history.push({
+            command,
+            startedAt: new Date(startMs),
+            durationMs: result.durationMs,
+            exitCode: result.exitCode,
+            ok: result.ok,
+        });
+    }
+    /**
+     * 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.
+     */
+    watchAutoRestart(job, script) {
+        job.onExit(() => {
+            if (job._disposed_)
+                return;
+            const replacement = this.spawnScript(script);
+            job._replace(replacement);
+            this.watchAutoRestart(job, script);
+        });
+    }
+    /**
+     * Registra handlers de proceso (`exit`, `SIGINT`, `SIGTERM`) para matar
+     * los jobs huérfanos al salir. Solo se registra una vez por sesión.
+     */
+    ensureCleanup() {
+        if (this._cleanupRegistered)
+            return;
+        this._cleanupRegistered = true;
+        const handler = () => {
+            this.killAll("SIGTERM");
+        };
+        process.once("exit", handler);
+        process.once("SIGINT", () => {
+            handler();
+            process.exit(130);
+        });
+        process.once("SIGTERM", handler);
+    }
+}
+//# sourceMappingURL=Shell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Shell.js","sourceRoot":"","sources":["../../../src/core/shell/Shell.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,GAIR,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,KAAK;IACC,KAAK,CAAU;IACxB,IAAI,CAAS;IACb,IAAI,CAAyB;IAC7B,QAAQ,GAAwB,IAAI,GAAG,EAAE,CAAC;IAC1C,QAAQ,GAAkB,EAAE,CAAC;IAC7B,KAAK,GAAqB,IAAI,GAAG,EAAE,CAAC;IACpC,kBAAkB,GAAG,KAAK,CAAC;IAEnC;;;;OAIG;IACH,YAAY,UAAuB,EAAE;QACnC,IAAI,CAAC,KAAK,GAAG,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;IAChC,CAAC;IAED,oEAAoE;IAEpE,iDAAiD;IACjD,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,sDAAsD;IACtD,IAAI,GAAG;QACL,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,sDAAsD;IACtD,IAAI,OAAO;QACT,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,uDAAuD;IACvD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,oEAAoE;IAEpE;;;;;OAKG;IACH,EAAE,CAAC,IAAY;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,GAAW,EAAE,KAAa;QAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAW;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAY,EAAE,OAAe;QACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,IAAY;QAClB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qEAAqE;IAErE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,CAAC,CACC,OAA6B,EAC7B,GAAG,MAAiB;QAEpB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;YACrB,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBACtB,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,OAAwB;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,qEAAqE;IAErE;;;;;;OAMG;IACH,WAAW,CAAC,MAAc;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,oEAAoE;IAEpE;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,IAAI,CAAC,GAAG,OAAiB;QAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAEtD,MAAM,OAAO,GAAkB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/C,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CACpE,CAAC;QAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,OAAO,CAAC,CAAC,CAAE,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,KAAM,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IACtC,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,KAAK,CAAC,GAAG,OAAiB;QAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,IAAI,MAAM,CAAC,MAAM;gBAAE,MAAM;QAC3B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,IAAY;QACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,IAAY;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oEAAoE;IAEpE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,EAAE,CAAC,MAAc,EAAE,OAAoB;QACrC,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QAClD,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,SAAS,CAAC,QAAQ,IAAI,kBAAkB,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;YACd,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;gBACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,GAAG,CAAC,WAAW,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YAClC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;gBACd,IAAI,GAAG,CAAC,UAAU;oBAAE,OAAO;gBAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBAC7C,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;gBAC1B,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED,8EAA8E;IAC9E,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,8CAA8C;IAC9C,IAAI,UAAU;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,SAAyB,SAAS;QACxC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,IAAI,GAAG,CAAC,OAAO;gBAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,oEAAoE;IAEpE;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,qEAAqE;IAErE,uCAAuC;IACvC,YAAY;QACV,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,oEAAoE;IAEpE;;;;;OAKG;IACK,YAAY,CAAC,KAAsB;QACzC,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,IAAI;YACd,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE;YACrC,GAAG,KAAK;SACT,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,cAAc,CAAC,MAAc;QACnC,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,SAAS,GACb,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAE7D,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;YAClD,IAAI,UAAU,KAAK,CAAC,CAAC;gBAAE,OAAO,WAAW,CAAC;YAC1C,OAAO,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,KAAc;QAC1B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;QAC7C,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,8BAA8B,OAAO,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;OAMG;IACK,aAAa,CACnB,OAAe,EACf,OAAe,EACf,MAAc;QAEd,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YACjB,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC;YAC5B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,EAAE,EAAE,MAAM,CAAC,EAAE;SACd,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACK,gBAAgB,CAAC,GAAQ,EAAE,MAAc;QAC/C,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;YACd,IAAI,GAAG,CAAC,UAAU;gBAAE,OAAO;YAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC7C,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC1B,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACK,aAAa;QACnB,IAAI,IAAI,CAAC,kBAAkB;YAAE,OAAO;QACpC,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAE/B,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC,CAAC;QAEF,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;YAC1B,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;CACF"}

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

@@ -0,0 +1,4 @@
+export { Shell } from "./Shell.js";
+export { Job } from "./Job.js";
+export type { ShellConfig, HistoryItem, JobOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/shell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/shell/index.js

@@ -0,0 +1,3 @@
+export { Shell } from "./Shell.js";
+export { Job } from "./Job.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/shell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC"}

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

@@ -0,0 +1,30 @@
+/** Opciones de configuración para una sesión de Shell. */
+export interface ShellConfig {
+    /** Directorio de trabajo inicial. Por defecto, `process.cwd()`. */
+    cwd?: string;
+    /** Variables de entorno adicionales. */
+    env?: Record<string, string>;
+    /** Shell a utilizar. Por defecto, `/bin/sh` o `cmd.exe`. */
+    shell?: string;
+}
+/** Entrada del historial de comandos ejecutados. */
+export interface HistoryItem {
+    /** Comando ejecutado (script original antes de resolver aliases). */
+    command: string;
+    /** Fecha y hora en la que comenzó la ejecución del comando. */
+    startedAt: Date;
+    /** Duración total de la ejecución en milisegundos. */
+    durationMs: number;
+    /** Código de salida del proceso (`null` si fue terminado por señal). */
+    exitCode: number | null;
+    /** `true` si el proceso terminó con código de salida 0. */
+    ok: boolean;
+}
+/** Opciones para lanzar un job en segundo plano. */
+export interface JobOptions {
+    /** Nombre identificador del job. Si no se provee, se genera uno automático. */
+    name?: string;
+    /** Si el proceso muere, se reinicia automáticamente. */
+    autoRestart?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/shell/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,SAAS,EAAE,IAAI,CAAC;IAChB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2DAA2D;IAC3D,EAAE,EAAE,OAAO,CAAC;CACb;AAED,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/core/shell/types.js

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

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

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from "./core/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "fullnative",
+  "version": "0.1.0",
+  "description": "TypeScript toolchain for Node.js — files, folders, processes, shell sessions, and env loading with a clean, object-oriented API.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build && npm run typecheck && npm test"
+  },
+  "keywords": [
+    "fullnative",
+    "nodejs",
+    "typescript",
+    "filesystem",
+    "process",
+    "shell",
+    "cli",
+    "scripting",
+    "dotenv",
+    "env"
+  ],
+  "author": "Zeltri",
+  "license": "MIT",
+  "homepage": "https://github.com/zeltri/full-native#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zeltri/full-native.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zeltri/full-native/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.10"
+  },
+  "engines": {
+    "node": ">=20.12.0"
+  }
+}