fullnative 0.1.0

package/dist/core/file/Folder.js

@@ -0,0 +1,427 @@
+import { promises as fs, watch } from "node:fs";
+import * as path from "node:path";
+import { File } from "./File.js";
+/**
+ * Representa un directorio accesible mediante una API sencilla.
+ */
+export class Folder {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    /** Nombre del directorio (último segmento de la ruta). */
+    get name() {
+        return path.basename(this.path);
+    }
+    /** Ruta absoluta del directorio padre. */
+    get parent() {
+        return path.dirname(this.path);
+    }
+    /** Instancia de `Folder` que representa al directorio padre. */
+    get parentDir() {
+        return new Folder(this.parent);
+    }
+    /** Ruta absoluta resuelta del directorio. */
+    get absolute() {
+        return path.resolve(this.path);
+    }
+    /**
+     * Verifica si el directorio existe en disco.
+     * @returns `true` si existe y es un directorio, `false` en caso contrario.
+     */
+    async exists() {
+        try {
+            const s = await fs.stat(this.path);
+            return s.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Indica si el directorio está vacío (sin entradas).
+     * @returns `true` si no existe o no contiene entradas, `false` si tiene contenido.
+     */
+    async isEmpty() {
+        if (!(await this.exists()))
+            return true;
+        return (await fs.readdir(this.path)).length === 0;
+    }
+    /**
+     * Obtiene los metadatos (stat) del directorio.
+     * @returns Una promesa con el objeto `Stats` de Node.js.
+     */
+    async stat() {
+        return fs.stat(this.path);
+    }
+    /**
+     * Obtiene la fecha de creación del directorio.
+     * @returns La fecha (`birthtime`) de creación.
+     */
+    async createdAt() {
+        return (await this.stat()).birthtime;
+    }
+    /**
+     * Obtiene la fecha de última modificación del directorio.
+     * @returns La fecha (`mtime`) de última modificación.
+     */
+    async modifiedAt() {
+        return (await this.stat()).mtime;
+    }
+    /**
+     * Calcula el tamaño total del directorio sumando el tamaño de todos los
+     * archivos contenidos recursivamente.
+     * @returns Tamaño total en bytes (0 si no existe).
+     */
+    async size() {
+        if (!(await this.exists()))
+            return 0;
+        let total = 0;
+        for (const item of await this.walk()) {
+            if (item instanceof File)
+                total += await item.size();
+        }
+        return total;
+    }
+    /**
+     * Crea el directorio (y sus padres) en disco.
+     * @returns Promesa que se resuelve al completar la creación.
+     */
+    async create() {
+        await fs.mkdir(this.path, { recursive: true });
+    }
+    /**
+     * Garantiza que el directorio exista, creándolo si es necesario.
+     * @returns Promesa que se resuelve al asegurar la existencia.
+     */
+    async ensure() {
+        if (!(await this.exists()))
+            await this.create();
+    }
+    /**
+     * Elimina el directorio del disco.
+     * @param recursive Si `true`, elimina recursivamente su contenido.
+     * @returns `true` si existía y fue eliminado, `false` si no existía.
+     */
+    async delete(recursive = false) {
+        if (!(await this.exists()))
+            return false;
+        await fs.rmdir(this.path, { recursive });
+        return true;
+    }
+    /**
+     * Vacía el directorio eliminando todo su contenido (archivos y subdirectorios)
+     * sin eliminar el directorio mismo.
+     * @returns Promesa que se resuelve al completar el vaciado.
+     */
+    async clear() {
+        if (!(await this.exists()))
+            return;
+        const entries = await fs.readdir(this.path, { withFileTypes: true });
+        for (const entry of entries) {
+            const full = path.join(this.path, entry.name);
+            if (entry.isDirectory()) {
+                await new Folder(full).delete(true);
+            }
+            else {
+                await fs.unlink(full);
+            }
+        }
+    }
+    /**
+     * Cambia los permisos del directorio.
+     * @param mode Máscode de permisos numérico (ej. `0o755`).
+     * @returns Promesa que se resuelve al completar el cambio.
+     */
+    async chmod(mode) {
+        await fs.chmod(this.path, mode);
+    }
+    /**
+     * Construye una referencia `File` a un archivo dentro de este directorio.
+     * @param name Nombre del archivo (relativo al directorio).
+     * @returns Una nueva instancia de `File` (no verifica existencia).
+     */
+    file(name) {
+        return new File(path.join(this.path, name));
+    }
+    /**
+     * Construye una referencia `Folder` a un subdirectorio de este directorio.
+     * @param name Nombre del subdirectorio (relativo al directorio).
+     * @returns Una nueva instancia de `Folder` (no verifica existencia).
+     */
+    dir(name) {
+        return new Folder(path.join(this.path, name));
+    }
+    /**
+     * Verifica si existe un archivo con el nombre dado dentro del directorio.
+     * @param name Nombre del archivo a buscar.
+     * @returns `true` si el archivo existe, `false` en caso contrario.
+     */
+    hasFile(name) {
+        return this.file(name).exists();
+    }
+    /**
+     * Verifica si existe un subdirectorio con el nombre dado.
+     * @param name Nombre del subdirectorio a buscar.
+     * @returns `true` si el subdirectorio existe, `false` en caso contrario.
+     */
+    async hasDir(name) {
+        return this.dir(name).exists();
+    }
+    /**
+     * Lista las entradas directas (archivos y subdirectorios) del directorio.
+     * @returns Arreglo de instancias `File` y `Folder`.
+     */
+    async list() {
+        const entries = await fs.readdir(this.path, { withFileTypes: true });
+        return entries.map((entry) => {
+            const full = path.join(this.path, entry.name);
+            return entry.isDirectory()
+                ? new Folder(full)
+                : new File(full);
+        });
+    }
+    /**
+     * Lista solo los archivos (no directorios) en el nivel actual.
+     * @returns Arreglo de instancias `File`.
+     */
+    async listFiles() {
+        const items = await this.list();
+        return items.filter((i) => i instanceof File);
+    }
+    /**
+     * Lista solo los subdirectorios en el nivel actual.
+     * @returns Arreglo de instancias `Folder`.
+     */
+    async listDirs() {
+        const items = await this.list();
+        return items.filter((i) => i instanceof Folder);
+    }
+    /**
+     * Lista los nombres de las entradas directas del directorio.
+     * @returns Arreglo de cadenas con los nombres de las entradas.
+     */
+    async listNames() {
+        return fs.readdir(this.path);
+    }
+    /**
+     * Lista los archivos del nivel actual cuya extensión coincide con `ext`.
+     * @param ext Extensión a filtrar (con o sin punto inicial, sin distinguir mayúsculas).
+     * @returns Arreglo de instancias `File` que coinciden.
+     */
+    async listByExt(ext) {
+        const files = await this.listFiles();
+        const lower = ext.toLowerCase().replace(/^\./, "");
+        return files.filter((f) => f.ext.toLowerCase() === lower);
+    }
+    /**
+     * Busca recursivamente un archivo por nombre exacto.
+     * @param name Nombre del archivo a buscar.
+     * @returns La instancia `File` si se encuentra, `undefined` en caso contrario.
+     */
+    async find(name) {
+        const items = await this.walk();
+        return items.find((i) => i instanceof File && i.name === name);
+    }
+    /**
+     * Busca recursivamente un subdirectorio por nombre exacto.
+     * @param name Nombre del subdirectorio a buscar.
+     * @returns La instancia `Folder` si se encuentra, `undefined` en caso contrario.
+     */
+    async findDir(name) {
+        const items = await this.walk();
+        return items.find((i) => i instanceof Folder && i.name === name);
+    }
+    /**
+     * Filtra archivos recursivamente mediante una expresión regular.
+     * Renombrado desde `glob()`: usa sintaxis **RegExp**, no patrones glob.
+     * @param pattern Expresión regular a probar contra la ruta completa de cada archivo.
+     * @returns Arreglo de instancias `File` cuya ruta coincide con el patrón.
+     */
+    async matchFiles(pattern) {
+        const items = await this.walk();
+        return items.filter((i) => i instanceof File && pattern.test(i.path));
+    }
+    /**
+     * Recorre recursivamente el directorio acumulando todas las entradas
+     * (archivos y subdirectorios) en un arreglo.
+     * @returns Arreglo con todas las instancias `File` y `Folder` encontradas.
+     */
+    async walk() {
+        const result = [];
+        if (!(await this.exists()))
+            return result;
+        const recurse = async (dir) => {
+            const items = await dir.list();
+            for (const item of items) {
+                result.push(item);
+                if (item instanceof Folder)
+                    await recurse(item);
+            }
+        };
+        await recurse(this);
+        return result;
+    }
+    /**
+     * Recorre recursivamente y devuelve solo los archivos.
+     * @returns Arreglo con todas las instancias `File` encontradas.
+     */
+    async walkFiles() {
+        const items = await this.walk();
+        return items.filter((i) => i instanceof File);
+    }
+    /**
+     * Recorre recursivamente y devuelve solo los subdirectorios.
+     * @returns Arreglo con todas las instancias `Folder` encontradas.
+     */
+    async walkDirs() {
+        const items = await this.walk();
+        return items.filter((i) => i instanceof Folder);
+    }
+    /**
+     * Versión streaming de `walk()` como async generator, ideal para carpetas
+     * grandes: produce entradas (`File` o `Folder`) a medida que se recorre el
+     * árbol, sin acumular todo en memoria.
+     * @yields Instancias `File` o `Folder` conforme se descubre cada entrada.
+     */
+    async *walkIter() {
+        if (!(await this.exists()))
+            return;
+        const items = await this.list();
+        for (const item of items) {
+            yield item;
+            if (item instanceof Folder) {
+                yield* item.walkIter();
+            }
+        }
+    }
+    /**
+     * Versión streaming de `walkFiles()` como async generator: produce solo
+     * archivos a medida que recorre el árbol, sin acumular todo en memoria.
+     * @yields Instancias `File` conforme se descubre cada archivo.
+     */
+    async *walkFilesIter() {
+        for await (const item of this.walkIter()) {
+            if (item instanceof File)
+                yield item;
+        }
+    }
+    /**
+     * Crea un archivo dentro de este directorio con el contenido indicado.
+     * @param name Nombre del archivo a crear.
+     * @param content Contenido inicial (cadena o `Buffer`, por defecto vacío).
+     * @returns La instancia `File` recién creada.
+     */
+    async createFile(name, content = "") {
+        const file = this.file(name);
+        await file.write(content);
+        return file;
+    }
+    /**
+     * Crea un subdirectorio dentro de este directorio (garantizando su existencia).
+     * @param name Nombre del subdirectorio a crear.
+     * @returns La instancia `Folder` del subdirectorio creado.
+     */
+    async createDir(name) {
+        const dir = this.dir(name);
+        await dir.ensure();
+        return dir;
+    }
+    /**
+     * Copia este directorio (y todo su contenido) a una ruta destino, creando
+     * el destino si no existe.
+     * @param dest Ruta absoluta del directorio destino.
+     * @returns Una **nueva** instancia de `Folder` apuntando al destino.
+     */
+    async copyTo(dest) {
+        const target = new Folder(dest);
+        await target.ensure();
+        for (const item of await this.list()) {
+            if (item instanceof File) {
+                await item.copyTo(path.join(dest, item.name));
+            }
+            else {
+                await item.copyTo(path.join(dest, item.name));
+            }
+        }
+        return target;
+    }
+    /**
+     * Copia este directorio dentro de otro, conservando su nombre.
+     * @param parent Ruta del directorio padre destino.
+     * @returns Una **nueva** instancia de `Folder` apuntando a `parent/name`.
+     */
+    async copyInto(parent) {
+        return this.copyTo(path.join(parent, this.name));
+    }
+    /**
+     * Mueve este directorio a una ruta destino. Crea el directorio padre del
+     * destino automáticamente si no existe. **Muta `this.path`** al nuevo destino
+     * y devuelve `this` para encadenamiento.
+     * @param dest Ruta absoluta del directorio destino.
+     * @returns La misma instancia (`this`) con `path` actualizado.
+     */
+    async moveTo(dest) {
+        await fs.mkdir(path.dirname(dest), { recursive: true });
+        await fs.rename(this.path, dest);
+        this.path = dest;
+        return this;
+    }
+    /**
+     * Mueve este directorio dentro de otro, conservando su nombre.
+     * **Muta `this.path`** y devuelve `this`.
+     * @param parent Ruta del directorio padre destino.
+     * @returns La misma instancia (`this`) con `path` actualizado.
+     */
+    async moveInto(parent) {
+        await this.moveTo(path.join(parent, this.name));
+        return this;
+    }
+    /**
+     * Renombra este directorio dentro de su mismo directorio padre.
+     * **Muta `this.path`** y devuelve `this`.
+     * @param newName Nuevo nombre del directorio (sin ruta).
+     * @returns La misma instancia (`this`) con `path` actualizado.
+     */
+    async rename(newName) {
+        await this.moveTo(path.join(this.parent, newName));
+        return this;
+    }
+    /**
+     * Observa cambios en el directorio de forma recursiva.
+     * @param callback Función invocada por cada evento (`change` o `rename`).
+     * @returns Un `FSWatcher` que debe cerrarse cuando ya no se necesite.
+     */
+    async watch(callback) {
+        return watch(this.path, { recursive: true }, callback);
+    }
+    /**
+     * Genera una representación visual en árbol (tipo `tree`) del directorio y
+     * su contenido recursivo.
+     * @returns Una cadena con la representación del árbol.
+     */
+    async tree() {
+        const lines = [];
+        const render = async (dir, prefix, isLast) => {
+            const connector = isLast ? "└── " : "├── ";
+            lines.push(`${prefix}${connector}${dir.name}/`);
+            const items = await dir.list();
+            const childPrefix = prefix + (isLast ? "    " : "│   ");
+            for (let i = 0; i < items.length; i++) {
+                const item = items[i];
+                const last = i === items.length - 1;
+                const childConnector = last ? "└── " : "├── ";
+                if (item instanceof Folder) {
+                    lines.push(`${childPrefix}${childConnector}${item.name}/`);
+                    await render(item, childPrefix + (last ? "    " : "│   "), true);
+                }
+                else {
+                    lines.push(`${childPrefix}${childConnector}${item.name}`);
+                }
+            }
+        };
+        await render(this, "", true);
+        return lines.join("\n");
+    }
+}
+//# sourceMappingURL=Folder.js.map

package/dist/core/file/Folder.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export { File } from "./file/File.js";
+export { Folder } from "./file/Folder.js";
+export { Process, Command, LiveProcess, Result, ProcessError, type ProcessOptions, } from "./process/index.js";
+export { Shell, Job, type ShellConfig, type HistoryItem, type JobOptions, } from "./shell/index.js";
+export { load, get, require } from "./env/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EACL,OAAO,EACP,OAAO,EACP,WAAW,EACX,MAAM,EACN,YAAY,EACZ,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,EACL,GAAG,EACH,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,6 @@
+export { File } from "./file/File.js";
+export { Folder } from "./file/Folder.js";
+export { Process, Command, LiveProcess, Result, ProcessError, } from "./process/index.js";
+export { Shell, Job, } from "./shell/index.js";
+export { load, get, require } from "./env/index.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EACL,OAAO,EACP,OAAO,EACP,WAAW,EACX,MAAM,EACN,YAAY,GAEb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,EACL,GAAG,GAIJ,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,94 @@
+import { LiveProcess } from "./LiveProcess.js";
+import { Result } from "./Result.js";
+import type { ProcessOptions } from "./types.js";
+/**
+ * Builder inmutable para construir un comando antes de ejecutarlo.
+ * Permite configurar opciones de forma fluida y luego ejecutar.
+ */
+export declare class Command {
+    private readonly _command;
+    private readonly _args;
+    private readonly _options;
+    /**
+     * Crea un nuevo `Command`.
+     *
+     * @param command - Comando a ejecutar.
+     * @param args - Argumentos del comando (por defecto, vacío).
+     * @param options - Opciones de ejecución (por defecto, vacío).
+     */
+    constructor(command: string, args?: readonly string[], options?: ProcessOptions);
+    /** Comando a ejecutar. */
+    get command(): string;
+    /** Argumentos del comando. */
+    get args(): readonly string[];
+    /**
+     * Crea una nueva instancia de `Command` con argumentos adicionales
+     * añadidos a los existentes.
+     *
+     * @param args - Argumentos a añadir.
+     * @returns Un nuevo `Command` inmutable con los argumentos combinados.
+     */
+    withArgs(...args: string[]): Command;
+    /**
+     * Crea una nueva instancia de `Command` cambiando el directorio de trabajo.
+     *
+     * @param cwd - Ruta del directorio de trabajo.
+     * @returns Un nuevo `Command` inmutable con el `cwd` actualizado.
+     */
+    in(cwd: string): Command;
+    /**
+     * Crea una nueva instancia de `Command` con variables de entorno adicionales,
+     * fusionadas con las existentes (o con `process.env` si no se habían definido).
+     *
+     * @param env - Variables de entorno a añadir o sobrescribir.
+     * @returns Un nuevo `Command` inmutable con el entorno actualizado.
+     */
+    withEnv(env: Record<string, string>): Command;
+    /**
+     * Crea una nueva instancia de `Command` con un timeout en milisegundos.
+     * Al expirar, el proceso se matará con `SIGTERM`.
+     *
+     * @param ms - Tiempo máximo de ejecución en milisegundos.
+     * @returns Un nuevo `Command` inmutable con el timeout configurado.
+     */
+    withTimeout(ms: number): Command;
+    /**
+     * Crea una nueva instancia de `Command` que envía datos por stdin al iniciar.
+     *
+     * @param data - Datos a enviar por stdin (texto o buffer).
+     * @returns Un nuevo `Command` inmutable con la entrada configurada.
+     */
+    withInput(data: string | Buffer): Command;
+    /**
+     * Crea una nueva instancia de `Command` que lanza un `ProcessError` si el
+     * proceso termina con código de salida distinto de 0. Esto hace que
+     * `run()` rechace la promesa en lugar de devolver un `Result` fallido.
+     *
+     * @returns Un nuevo `Command` inmutable con `rejectOnNonZero` activado.
+     */
+    throwOnError(): Command;
+    /**
+     * Inicia el comando y devuelve un `LiveProcess` para interactuar en vivo
+     * con stdin/stdout/stderr.
+     *
+     * @returns Un `LiveProcess` que envuelve el proceso hijo recién iniciado.
+     */
+    spawn(): LiveProcess;
+    /**
+     * Ejecuta el comando, espera a que termine y devuelve el resultado.
+     * Si se configuró `throwOnError`, rechaza con `ProcessError` si el código
+     * de salida no es 0.
+     *
+     * @returns El `Result` de la ejecución.
+     * @throws {ProcessError} Si `rejectOnNonZero` está activo y el código de salida no es 0.
+     */
+    run(): Promise<Result>;
+    /**
+     * Ejecuta el comando y devuelve solo stdout, con espacios en blanco
+     * eliminados de los extremos (trim).
+     *
+     * @returns El stdout del comando ya trimado.
+     */
+    output(): Promise<string>;
+}
+//# sourceMappingURL=Command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Command.d.ts","sourceRoot":"","sources":["../../../src/core/process/Command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C;;;;;;OAMG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,SAAS,MAAM,EAAO,EAAE,OAAO,GAAE,cAAmB;IAMvF,0BAA0B;IAC1B,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,8BAA8B;IAC9B,IAAI,IAAI,IAAI,SAAS,MAAM,EAAE,CAE5B;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO;IAIpC;;;;;OAKG;IACH,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIxB;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;IAQ7C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIhC;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO;IAIzC;;;;;;OAMG;IACH,YAAY,IAAI,OAAO;IAOvB;;;;;OAKG;IACH,KAAK,IAAI,WAAW;IAmBpB;;;;;;;OAOG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAO5B;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;CAGhC"}