@batistafull/deploy-server 3.0.0 → 4.0.0

package/README.md

@@ -58,6 +58,7 @@ Crea `deploy.config.json` en la raíz de tu proyecto. **Este archivo lo creas t
   "ftp": {
     "enabled": false,
     "host": "ftp.example.com",
+    "port": 21,
     "secure": true,
     "remotePath": "/public_html"
   }
@@ -66,16 +67,18 @@ 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).                   |
-| `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. |
+| 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
 
@@ -98,12 +101,13 @@ Cada entrada es una ruta **relativa al proyecto** (no un nombre suelto), scopead
 
 ### 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.                                                    |
 
@@ -126,10 +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 cada entrada de `sources` → `<output>` (aplicando `exclude`).
-5. 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,4 +1,5 @@
 const path = require("path");
+const os = require("os");
 const fs = require("fs-extra");
 const chalk = require("chalk");
 const { execSync } = require("child_process");
@@ -80,10 +81,7 @@ module.exports = async function deploy(options) {
   const config = require(path.resolve(process.cwd(), options.config));
 
   const projectRoot = process.cwd();
-
-  if (!config.output) {
-    throw new Error("Falta 'output' en el config: indica la carpeta destino del deploy.");
-  }
+  const ftpEnabled = !!config.ftp?.enabled;
 
   if (!Array.isArray(config.sources) || config.sources.length === 0) {
     throw new Error(
@@ -91,17 +89,30 @@ module.exports = async function deploy(options) {
     );
   }
 
-  // '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;
 
-  // Clean
-  if (options.clean) {
-    console.log(chalk.gray("🧹 Cleaning output..."));
-    await fs.remove(outputPath);
-  }
+  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);
+    }
 
-  await fs.ensureDir(outputPath);
+    await fs.ensureDir(outputPath);
+  }
 
   // BUILD (ARRAY)
   if (Array.isArray(config.buildCommand)) {
@@ -117,7 +128,7 @@ module.exports = async function deploy(options) {
   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.
@@ -125,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;
@@ -138,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);
@@ -146,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,6 +1,6 @@
 {
   "name": "@batistafull/deploy-server",
-  "version": "3.0.0",
+  "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": {