@batistafull/deploy-server 2.0.0 → 4.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @batistafull/deploy-server
 
-Herramienta CLI de despliegue dirigida por configuración. Ejecuta los comandos de build de tu proyecto y copia las carpetas `dist` y `server` a la carpeta destino que indiques, con opción de subir el resultado por FTP/FTPS.
+Herramienta CLI de despliegue dirigida por configuración. Ejecuta los comandos de build de tu proyecto y copia las carpetas, archivos o globs que indiques a la carpeta destino, con opción de subir el resultado por FTP/FTPS.
 
 ## Instalación
 
@@ -52,13 +52,13 @@ Crea `deploy.config.json` en la raíz de tu proyecto. **Este archivo lo creas t
 ```json
 {
   "output": "C:/inetpub/app.host",
-  "dist": "dist",
-  "server": "api",
+  "sources": ["dist/", "api/", "robots.txt"],
   "buildCommand": ["npm install", "npm run build"],
-  "exclude": ["node_modules", ".git", ".env"],
+  "exclude": ["dist/.htaccess", "api/node_modules"],
   "ftp": {
     "enabled": false,
     "host": "ftp.example.com",
+    "port": 21,
     "secure": true,
     "remotePath": "/public_html"
   }
@@ -67,26 +67,47 @@ Crea `deploy.config.json` en la raíz de tu proyecto. **Este archivo lo creas t
 
 ### Campos
 
-| Campo          | Tipo                  | Descripción                                                   |
-| -------------- | --------------------- | ------------------------------------------------------------- |
-| `output`       | `string`              | Ruta destino del deploy (ver nota abajo).                     |
-| `dist`         | `string`              | Ruta (relativa al proyecto) de la carpeta compilada a copiar. |
-| `server`       | `string`              | Ruta (relativa al proyecto) de la carpeta del servidor/API.   |
-| `buildCommand` | `string` o `string[]` | Comando(s) de build. Si es un array, se ejecutan en orden.    |
-| `exclude`      | `string[]`            | Nombres de archivos o carpetas a excluir al copiar.           |
-| `ftp`          | `object`              | (Opcional) Configuración de subida por FTP/FTPS. Ver abajo.   |
+| Campo          | Tipo                  | Descripción                                                     |
+| -------------- | --------------------- | --------------------------------------------------------------- |
+| `output`       | `string`              | Ruta destino local (ver nota). Se ignora si el FTP está activo. |
+| `sources`      | `string[]`            | Carpetas, archivos o globs a copiar (ver abajo).                |
+| `buildCommand` | `string` o `string[]` | Comando(s) de build. Si es un array, se ejecutan en orden.      |
+| `exclude`      | `string[]`            | Rutas a excluir, relativas al proyecto (ver abajo).             |
+| `ftp`          | `object`              | (Opcional) Configuración de subida por FTP/FTPS. Ver abajo.     |
 
 > **`output`:** si es una ruta **absoluta** se usa tal cual (ej: `C:/inetpub/app.host`);
 > si es **relativa** se resuelve desde la raíz del proyecto (ej: `../deploy/app.host`).
+> **Con FTP activo (`ftp.enabled: true`) no se deja copia local:** los archivos se
+> preparan en una carpeta temporal, se suben y se borra. En ese caso `output` no es necesario.
+
+### `sources` — qué se copia
+
+Cada entrada es una carpeta, un archivo o un glob, relativo a la raíz del proyecto:
+
+| Entrada      | Significado                                                                      |
+| ------------ | -------------------------------------------------------------------------------- |
+| `dist/`      | Carpeta completa (recursivo). Su contenido se copia a la raíz del output.        |
+| `dist/*.css` | Glob: solo los `.css` del primer nivel de `dist`, copiados a la raíz del output. |
+| `robots.txt` | Un archivo suelto, copiado por su nombre a la raíz del output.                   |
+
+En todos los casos el contenido se copia a la **raíz del output** (se quita la carpeta base). Las carpetas se indican con `/` al final.
+
+### `exclude` — qué se omite
+
+Cada entrada es una ruta **relativa al proyecto** (no un nombre suelto), scopeada a la carpeta de origen:
+
+- `"dist/.htaccess"` → omite ese archivo concreto dentro de `dist`.
+- `"api/node_modules"` → omite esa carpeta entera (y su contenido) dentro de `api`.
 
 ### FTP / FTPS
 
-La subida por FTP está desactivada salvo que pongas `ftp.enabled: true`.
+La subida por FTP está desactivada salvo que pongas `ftp.enabled: true`. **Cuando está activa, `output` se ignora** (no se genera copia local: se usa una carpeta temporal que se borra tras subir).
 
 | Campo            | Descripción                                                                |
 | ---------------- | -------------------------------------------------------------------------- |
-| `ftp.enabled`    | `true` para activar la subida.                                             |
+| `ftp.enabled`    | `true` para activar la subida. Si está activo, `output` se ignora.         |
 | `ftp.host`       | Host del servidor FTP (fallback de `FTP_HOST`).                            |
+| `ftp.port`       | Puerto (fallback de `FTP_PORT`). Por defecto `21`.                         |
 | `ftp.secure`     | `true` (por defecto) usa FTPS con TLS. Pon `false` solo si no hay soporte. |
 | `ftp.remotePath` | Carpeta remota destino.                                                    |
 
@@ -109,11 +130,11 @@ Si el FTP está habilitado y faltan `FTP_HOST`, `FTP_USER` o `FTP_PASSWORD` (y t
 ## Qué hace, paso a paso
 
 1. Carga el `deploy.config.json`.
-2. Si se pasa `--clean`, borra la carpeta de salida.
-3. Ejecuta el/los `buildCommand`.
-4. Copia `dist` → `<output>` (aplicando `exclude`).
-5. Copia `server` → `<output>` (aplicando `exclude`).
-6. Si `ftp.enabled`, sube la carpeta de salida por FTP/FTPS.
+2. Determina el destino: la carpeta `output`, o una temporal si el FTP está activo.
+3. Si se pasa `--clean` (y hay `output` local), borra la carpeta de salida.
+4. Ejecuta el/los `buildCommand`.
+5. Copia cada entrada de `sources` → destino (aplicando `exclude`).
+6. Si `ftp.enabled`, sube los archivos por FTP/FTPS y borra la carpeta temporal.
 
 ## Licencia
 

package/lib/deploy.js

@@ -1,8 +1,10 @@
 const path = require("path");
+const os = require("os");
 const fs = require("fs-extra");
 const chalk = require("chalk");
 const { execSync } = require("child_process");
 const ftp = require("basic-ftp");
+const fg = require("fast-glob");
 
 // Ejecuta una lista de comandos de build en orden
 function runBuildCommands(commands, cwd) {
@@ -12,49 +14,106 @@ function runBuildCommands(commands, cwd) {
   }
 }
 
-// Copia un directorio excluyendo los patrones indicados (match por nombre o ruta relativa)
-async function copyFiltered(srcPath, destPath, exclude = []) {
-  if (!(await fs.pathExists(srcPath))) {
-    console.log(chalk.yellow(`⚠️  Origen no encontrado, se omite: ${srcPath}`));
-    return;
+// Dado un patrón (con "/"), calcula el patrón glob y la carpeta base a "quitar"
+// al copiar hacia el output.
+//   "dist/"        -> { glob: "dist/**/*",  base: "dist" }  (carpeta completa)
+//   "dist/*.css"   -> { glob: "dist/*.css", base: "dist" }  (glob dentro de dist)
+//   "dist/app.js"  -> { glob: "dist/app.js", base: "dist" } (archivo suelto)
+function resolveSource(raw) {
+  const source = raw.replace(/\\/g, "/");
+  const hasGlob = (s) => /[*?[\]{}!()]/.test(s);
+
+  if (source.endsWith("/")) {
+    const dir = source.replace(/\/+$/, "");
+    return { glob: `${dir}/**/*`, base: dir };
   }
 
-  await fs.copy(srcPath, destPath, {
-    filter: (src) => {
-      const relative = path.relative(srcPath, src);
-      if (!relative) return true; // el propio directorio raíz
-      const name = path.basename(src);
-      return !exclude.some(
-        (pattern) => name === pattern || relative.split(path.sep).includes(pattern)
-      );
+  if (hasGlob(source)) {
+    // base = prefijo estático anterior al primer segmento con comodines
+    const baseSegs = [];
+    for (const seg of source.split("/")) {
+      if (hasGlob(seg)) break;
+      baseSegs.push(seg);
     }
+    return { glob: source, base: baseSegs.join("/") || "." };
+  }
+
+  // archivo (o carpeta sin "/") suelto: se copia bajo su nombre
+  return { glob: source, base: path.posix.dirname(source) };
+}
+
+// Copia cada 'source' al output. Los 'exclude' son rutas relativas al proyecto
+// (ej: "dist/.htaccess") y se aplican como patrones ignorados.
+async function copySources(sources, outputPath, exclude, projectRoot) {
+  // Para excluir una carpeta entera basta con nombrarla; añadimos "/**" para
+  // cubrir también su contenido.
+  const ignore = exclude.flatMap((e) => {
+    const p = e.replace(/\\/g, "/").replace(/\/+$/, "");
+    return [p, `${p}/**`];
   });
+
+  for (const raw of sources) {
+    const { glob, base } = resolveSource(raw);
+
+    const matches = await fg(glob, {
+      cwd: projectRoot,
+      dot: true,
+      onlyFiles: true,
+      ignore
+    });
+
+    if (matches.length === 0) {
+      console.log(chalk.yellow(`⚠️  Sin coincidencias, se omite: ${raw}`));
+      continue;
+    }
+
+    console.log(chalk.blue(`📦 Copiando ${raw} (${matches.length} archivo(s))...`));
+    for (const rel of matches) {
+      const from = path.join(projectRoot, rel);
+      const dest = path.join(outputPath, path.relative(base, rel));
+      await fs.ensureDir(path.dirname(dest));
+      await fs.copy(from, dest);
+    }
+  }
 }
 
 module.exports = async function deploy(options) {
   const config = require(path.resolve(process.cwd(), options.config));
 
   const projectRoot = process.cwd();
+  const ftpEnabled = !!config.ftp?.enabled;
 
-  if (!config.output) {
-    throw new Error("Falta 'output' en el config: indica la carpeta destino del deploy.");
+  if (!Array.isArray(config.sources) || config.sources.length === 0) {
+    throw new Error(
+      "Falta 'sources' en el config: indica un array de carpetas/archivos a copiar (ej: [\"dist/\", \"api/\"])."
+    );
   }
 
-  // 'output' es la ruta destino. Si es absoluta se usa tal cual;
-  // si es relativa se resuelve desde la raíz del proyecto.
-  const outputPath = path.resolve(projectRoot, config.output);
+  // Con FTP no se deja copia local: se usa una carpeta temporal solo para
+  // preparar la subida y se borra al terminar. Sin FTP se requiere 'output'.
+  let outputPath;
+  let staging = false;
 
-  const distPath = path.join(projectRoot, config.dist);
-  const serverPath = path.join(projectRoot, config.server);
+  if (ftpEnabled) {
+    outputPath = await fs.mkdtemp(path.join(os.tmpdir(), "deploy-server-"));
+    staging = true;
+  } else {
+    if (!config.output) {
+      throw new Error("Falta 'output' en el config: indica la carpeta destino del deploy.");
+    }
+    // 'output' es la ruta destino. Si es absoluta se usa tal cual;
+    // si es relativa se resuelve desde la raíz del proyecto.
+    outputPath = path.resolve(projectRoot, config.output);
+
+    // Clean
+    if (options.clean) {
+      console.log(chalk.gray("🧹 Cleaning output..."));
+      await fs.remove(outputPath);
+    }
 
-  // Clean
-  if (options.clean) {
-    console.log(chalk.gray("🧹 Cleaning output..."));
-    await fs.remove(outputPath);
+    await fs.ensureDir(outputPath);
   }
 
-  await fs.ensureDir(outputPath);
-
   // BUILD (ARRAY)
   if (Array.isArray(config.buildCommand)) {
     runBuildCommands(config.buildCommand, projectRoot);
@@ -65,16 +124,11 @@ module.exports = async function deploy(options) {
     });
   }
 
-  // COPY DIST
-  console.log(chalk.blue("📦 Copying dist..."));
-  await copyFiltered(distPath, outputPath, config.exclude || []);
-
-  // COPY SERVER
-  console.log(chalk.blue("📦 Copying server..."));
-  await copyFiltered(serverPath, outputPath, config.exclude || []);
+  // COPY SOURCES
+  await copySources(config.sources, outputPath, config.exclude || [], projectRoot);
 
   // FTP (opcional)
-  if (config.ftp?.enabled) {
+  if (ftpEnabled) {
     const client = new ftp.Client();
 
     // Las credenciales se leen preferentemente de variables de entorno.
@@ -82,6 +136,7 @@ module.exports = async function deploy(options) {
     const host = process.env.FTP_HOST || config.ftp.host;
     const user = process.env.FTP_USER || config.ftp.user;
     const password = process.env.FTP_PASSWORD || config.ftp.password;
+    const port = Number(process.env.FTP_PORT || config.ftp.port) || undefined;
     // FTPS por defecto; poner ftp.secure=false en el config solo si el
     // servidor no soporta TLS (no recomendado).
     const secure = config.ftp.secure !== false;
@@ -95,7 +150,7 @@ module.exports = async function deploy(options) {
     console.log(chalk.yellow(`📡 Connecting FTP (${secure ? "FTPS" : "sin cifrar"})...`));
 
     try {
-      await client.access({ host, user, password, secure });
+      await client.access({ host, port, user, password, secure });
 
       await client.ensureDir(config.ftp.remotePath);
       await client.uploadFromDir(outputPath);
@@ -103,6 +158,10 @@ module.exports = async function deploy(options) {
       console.log(chalk.green("🌐 FTP upload done"));
     } finally {
       client.close();
+      // Borra la carpeta temporal de preparación (no se deja copia local).
+      if (staging) {
+        await fs.remove(outputPath);
+      }
     }
   }
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@batistafull/deploy-server",
-  "version": "2.0.0",
-  "description": "Deploy tool that builds and copies dist + api to Documents/app.host",
+  "version": "4.0.0",
+  "description": "Config-driven deploy tool that builds and copies folders, files or globs to a target path, with optional FTP/FTPS upload",
   "main": "bin/deploy-server.js",
   "bin": {
     "deploy-server": "bin/deploy-server.js"
@@ -10,7 +10,11 @@
     "bin/",
     "lib/"
   ],
-  "keywords": ["deploy", "cli", "nodejs"],
+  "keywords": [
+    "deploy",
+    "cli",
+    "nodejs"
+  ],
   "author": "batistafull",
   "license": "MIT",
   "type": "commonjs",
@@ -21,6 +25,7 @@
     "basic-ftp": "^5.0.5",
     "chalk": "^4.1.2",
     "commander": "^12.1.0",
+    "fast-glob": "^3.3.3",
     "fs-extra": "^11.2.0"
   }
-}
+}