qdd-framework 2.9.7 → 2.9.9

package/README.md

@@ -10,9 +10,12 @@
 ## 🚀 Instalación Rápida
 
 ```bash
-npm install -g qdd-framework
+npm install -g qdd-framework --allow-scripts=qdd-framework
 ```
 
+npm 12 no corre los scripts de instalación sin esa bandera. Si instalas sin ella, la primera vez que uses `qdd` se baja su
+binario desde el release de GitHub de esa versión, fuera del bloqueo de npm.
+
 > **Conflicto con el paquete `qdd` de npm:** existe un paquete ajeno llamado `qdd` (no pertenece a QDD Framework) que también instala un comando `qdd`. Si lo tienes instalado globalmente, desinstálalo antes (`npm uninstall -g qdd`) para que `qdd` apunte a QDD Framework. Desde v1.9.22 su presencia ya no rompe la instalación (antes fallaba con `EISDIR`).
 
 ---

package/bin/qdd.js

@@ -3,9 +3,23 @@
 const { spawnSync } = require('child_process');
 const path = require('path');
 const os = require('os');
+const fs = require('fs');
 
 const binaryExt = os.platform() === 'win32' ? '.exe' : '';
 const binaryPath = path.join(__dirname, `qdd${binaryExt}`);
+const instalador = path.join(__dirname, '..', 'install.js');
+
+// Con npm 12, quien instala sin --allow-scripts=qdd-framework no corrió el postinstall (FND-143): el primer qdd baja el
+// binario con el mismo instalador. Lo que escribe va a stderr: otro programa puede estar leyendo la salida de qdd.
+function bajarAlPrimerUso() {
+  if (fs.existsSync(binaryPath) || !fs.existsSync(instalador)) {
+    return;
+  }
+  console.error('[QDD] qdd no tiene su binario: lo bajo ahora, porque npm no corrió su instalación.');
+  spawnSync(process.execPath, [instalador, '--primer-uso'], { stdio: ['ignore', 2, 'inherit'] });
+}
+
+bajarAlPrimerUso();
 
 const result = spawnSync(binaryPath, process.argv.slice(2), {
   stdio: 'inherit'
@@ -13,14 +27,14 @@ const result = spawnSync(binaryPath, process.argv.slice(2), {
 
 // Sin binario, lo más probable es que npm esté reinstalando qdd: 75 es «todavía no» para los pedidos del panel (FND-135).
 if (result.error && result.error.code === 'ENOENT') {
-  console.error('[QDD] qdd se está actualizando: inténtalo de nuevo en un momento.');
-  console.error('[QDD] Si sigue así, reinstala el paquete con: npm install -g qdd-framework');
+  console.error('[QDD] qdd no tiene su binario: se está actualizando, o npm bloqueó su instalación (npm 12 lo hace por defecto).');
+  console.error('[QDD] Si sigue así, reinstala el paquete con: npm install -g qdd-framework --allow-scripts=qdd-framework');
   process.exit(75);
 }
 
 if (result.error) {
   console.error(`[QDD] No se pudo ejecutar el binario nativo ${binaryPath}: ${result.error.message}`);
-  console.error('[QDD] Reinstala el paquete con: npm install -g qdd-framework');
+  console.error('[QDD] Reinstala el paquete con: npm install -g qdd-framework --allow-scripts=qdd-framework');
   process.exit(1);
 }
 

package/install.js

@@ -9,6 +9,8 @@ const VERSION = 'v' + pkg.version;
 const REPO = 'trdago/qdd-framework';
 // TOPE_VERSION_MS: el antivirus puede demorar la primera ejecución de un binario recién descargado.
 const TOPE_VERSION_MS = 60000;
+// TOPE_TURNO_MS: un turno más viejo que esto quedó abandonado; bajar el binario tarda mucho menos.
+const TOPE_TURNO_MS = 5 * 60 * 1000;
 
 const platformMap = {
   win32: 'windows',
@@ -73,6 +75,10 @@ function main() {
     fs.mkdirSync(binDir, { recursive: true });
   }
 
+  if (process.argv.includes('--primer-uso')) {
+    pedirTurno(path.join(binDir, '.bajando'));
+  }
+
   const binarioLocal = resolverBinarioLocal(__dirname, binaryName);
   if (binarioLocal) {
     console.log(`[QDD] Binario local detectado en ${binarioLocal}. Usando copia local para desarrollo...`);
@@ -85,10 +91,52 @@ function main() {
   descargarDesdeRelease({ os, arch, ext, binaryName, binDir });
 }
 
+// tomarTurno: varios qdd sin binario a la vez (un panel, por ejemplo) no bajan cada uno el suyo.
+function tomarTurno(ruta) {
+  try {
+    fs.closeSync(fs.openSync(ruta, 'wx'));
+    return true;
+  } catch (err) {
+    if (err.code !== 'EEXIST') {
+      throw err;
+    }
+  }
+  if (Date.now() - fs.statSync(ruta).mtimeMs < TOPE_TURNO_MS) {
+    return false;
+  }
+  fs.rmSync(ruta, { force: true });
+  return tomarTurno(ruta);
+}
+
+// pedirTurno sale con 75, el «todavía no» de los pedidos, si otro qdd ya lo está bajando.
+function pedirTurno(ruta) {
+  try {
+    if (!tomarTurno(ruta)) {
+      console.error('[QDD] Otro proceso ya está bajando el binario.');
+      process.exit(75);
+    }
+  } catch (err) {
+    fallar(`no se pudo escribir en la carpeta del paquete: ${err.message}`);
+  }
+  process.on('exit', () => fs.rmSync(ruta, { force: true }));
+}
+
+// carpetaDeDescarga es propia de este proceso: un postinstall y un primer uso pueden correr a la vez.
+function carpetaDeDescarga() {
+  try {
+    const carpeta = fs.mkdtempSync(path.join(__dirname, 'descarga-'));
+    process.on('exit', () => fs.rmSync(carpeta, { recursive: true, force: true }));
+    return carpeta;
+  } catch (err) {
+    return fallar(`no se pudo escribir en la carpeta del paquete: ${err.message}`);
+  }
+}
+
 // 2. Descarga desde GitHub Releases
 function descargarDesdeRelease({ os, arch, ext, binaryName, binDir }) {
   const url = `https://github.com/${REPO}/releases/download/${VERSION}/qdd_${os}_${arch}.${ext}`;
-  const downloadDest = path.join(__dirname, `qdd-download.${ext}`);
+  const carpeta = carpetaDeDescarga();
+  const downloadDest = path.join(carpeta, `qdd-download.${ext}`);
 
   console.log(`[QDD] Descargando binario nativo para ${os}-${arch}...`);
   console.log(`[QDD] URL: ${url}`);
@@ -121,7 +169,7 @@ function descargarDesdeRelease({ os, arch, ext, binaryName, binDir }) {
   function extractBinary() {
     console.log('[QDD] Extrayendo...');
     try {
-      const bin = instalarDescarga({ os, paquete: downloadDest, carpeta: __dirname, binaryName, binDir, env: process.env });
+      const bin = instalarDescarga({ os, paquete: downloadDest, carpeta, binaryName, binDir, env: process.env });
       console.log('[QDD] ¡Instalación nativa completada exitosamente!');
       actualizarConsola(bin);
     } catch (err) {
@@ -164,7 +212,7 @@ function codigoDeFalla(env) {
 
 function fallar(motivo) {
   console.error(`[QDD] La instalación falló: ${motivo}`);
-  console.error('[QDD] Para reintentar: npm install -g qdd-framework');
+  console.error('[QDD] Para reintentar: npm install -g qdd-framework --allow-scripts=qdd-framework');
   process.exit(codigoDeFalla(process.env));
 }
 
@@ -178,7 +226,7 @@ function actualizarConsola(bin) {
   }
 }
 
-module.exports = { esArchivo, estaDentroDeNodeModules, resolverBinarioLocal, comandoExtraer, instalarDescarga, codigoDeFalla };
+module.exports = { esArchivo, estaDentroDeNodeModules, resolverBinarioLocal, comandoExtraer, instalarDescarga, codigoDeFalla, tomarTurno };
 
 if (require.main === module) {
   main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qdd-framework",
-  "version": "2.9.7",
+  "version": "2.9.9",
   "description": "Quality-Driven Development Framework",
   "bin": {
     "qdd": "bin/qdd.js"