@saulwade/swl-ses 1.5.1 → 1.6.0

package/scripts/actualizar.js

@@ -5,9 +5,15 @@
  * Actualiza componentes instalados preservando _userland/.
  * Interactivo: muestra versiones, pide confirmación, muestra progreso.
  * No-interactivo con --force o sin TTY.
+ *
+ * Modo --check (read-only):
+ *   Solo muestra el estado actual de versiones (local vs npm vs runtimes instalados).
+ *   No pide confirmación. No actualiza nada. Util para el autor o usuarios que
+ *   quieren verificar si están al dia sin esperar al hook automatico.
  */
 
 const fs = require('fs');
+const os = require('os');
 const path = require('path');
 const { detectarRuntimes } = require('./lib/detectar-runtime');
 const { cargarEstado } = require('./lib/estado');
@@ -15,7 +21,7 @@ const {
   color, icono, encabezado, formatearPaso, formatearAdvertencia,
   spinner, preguntarSiNo, lineaSeparadora, ES_TTY,
 } = require('./lib/ui');
-const { versionRemotaParalela } = require('./lib/npm-version');
+const { versionRemotaParalela, compararSemver } = require('./lib/npm-version');
 
 const VERSION_LOCAL = require('../package.json').version;
 
@@ -28,7 +34,110 @@ async function obtenerVersionRemota() {
   return r.version || VERSION_LOCAL;
 }
 
+/**
+ * Modo --check: muestra el estado actual sin actualizar. Read-only.
+ *
+ * Salida:
+ *   - Version del paquete que esta ejecutando este CLI (VERSION_LOCAL).
+ *   - Version mas reciente publicada en npm.
+ *   - Comparacion semver: al dia / adelantado / atras.
+ *   - Estado del hook check-update.js: ultima verificacion automatica.
+ *   - Tabla por runtime instalado (si los detecta) con su versionSistema.
+ */
+async function checkStatus() {
+  console.log(encabezado('swl-ses update --check', VERSION_LOCAL));
+
+  // Resolver version remota con timeout corto
+  const remota = await obtenerVersionRemota();
+  const cmp = compararSemver(VERSION_LOCAL, remota);
+
+  let estadoVersion;
+  if (cmp === null) {
+    estadoVersion = color.amarillo('Comparacion no disponible (formato inesperado)');
+  } else if (cmp === 0) {
+    estadoVersion = color.verde('Al dia');
+  } else if (cmp < 0) {
+    estadoVersion = color.amarillo(`Nueva version disponible (${remota})`);
+  } else {
+    estadoVersion = color.dim(`Local mas reciente que npm (${VERSION_LOCAL} > ${remota}, publicacion pendiente)`);
+  }
+
+  console.log(`  Paquete ejecutado:  ${color.negrita('v' + VERSION_LOCAL)}`);
+  console.log(`  Version en npm:     ${color.negrita('v' + remota)}`);
+  console.log(`  Estado:             ${estadoVersion}`);
+  console.log('');
+
+  // Estado del hook automatico (check-update.js).
+  // SWL_UPDATE_FLAG_PATH override solo para tests (evita race con flag único).
+  const flagPath = process.env.SWL_UPDATE_FLAG_PATH || path.join(os.tmpdir(), 'swl-ses-update-check.json');
+  try {
+    const flag = JSON.parse(fs.readFileSync(flagPath, 'utf8'));
+    const horas = ((Date.now() - flag.timestamp) / 3600000).toFixed(1);
+    console.log(`  ${color.negrita('Hook automatico (check-update.js):')}`);
+    console.log(`    Ultima verificacion: hace ${horas}h`);
+    console.log(`    Local registrada:    ${flag.local}`);
+    console.log(`    Remota registrada:   ${flag.remota || color.dim('(no resuelta)')}`);
+    console.log(`    hayNueva:            ${flag.hayNueva ? color.amarillo('si') : color.verde('no')}`);
+    console.log(`    Flag:                ${flagPath}`);
+  } catch {
+    console.log(`  ${color.negrita('Hook automatico (check-update.js):')}`);
+    console.log(`    ${color.dim('Sin flag de throttle — el hook nunca se ha ejecutado en este equipo,')}`);
+    console.log(`    ${color.dim('o el archivo temp/swl-ses-update-check.json fue removido.')}`);
+  }
+  console.log('');
+
+  // Estado por runtime instalado
+  const runtimes = detectarRuntimes();
+  if (runtimes.length === 0) {
+    console.log(formatearAdvertencia('Runtimes', 'No se detectaron runtimes con instalacion SWL'));
+    console.log('');
+    return;
+  }
+
+  console.log(`  ${color.negrita('Runtimes detectados:')}`);
+  let totalRuntimes = 0;
+  for (const runtime of runtimes) {
+    const dirs = [runtime.global, path.resolve(runtime.local)];
+    for (const dir of dirs) {
+      if (!fs.existsSync(dir)) continue;
+      const estado = cargarEstado(dir);
+      if (!estado) continue;
+
+      const esGlobal = dir === runtime.global;
+      const ubicacion = esGlobal ? 'global' : 'proyecto';
+      const v = estado.versionSistema || 'desconocida';
+
+      const cmpRuntime = compararSemver(v, remota);
+      let etiqueta;
+      if (cmpRuntime === null) {
+        etiqueta = color.dim('(version no reconocida)');
+      } else if (cmpRuntime === 0) {
+        etiqueta = color.verde('al dia');
+      } else if (cmpRuntime < 0) {
+        etiqueta = color.amarillo(`atrasada (npm: ${remota})`);
+      } else {
+        etiqueta = color.dim('adelantada');
+      }
+
+      console.log(`    ${runtime.nombre} (${ubicacion}): v${v}  ${etiqueta}`);
+      totalRuntimes++;
+    }
+  }
+  if (totalRuntimes === 0) {
+    console.log(`    ${color.dim('(ninguno con .swl-install-state.json valido)')}`);
+  }
+  console.log('');
+  console.log(`  ${color.dim('Modo --check es read-only. Para actualizar:')} npx -y @saulwade/swl-ses@latest update`);
+  console.log('');
+}
+
 async function update(opciones) {
+  // Modo read-only: solo reportar estado, no tocar nada
+  if (opciones.check) {
+    await checkStatus();
+    return;
+  }
+
   const force = opciones.force || !ES_TTY;
 
   // Obtener la versión más reciente del registro npm