@saulwade/swl-ses 2.3.0 → 2.4.1

package/scripts/audit-tools/bundle-tracker.js

@@ -1,290 +1,290 @@
-// Adaptado de temp/ultraship-main/tools/bundle-tracker.mjs bajo MIT License
-// Fuente: Houseofmvps/ultraship (https://github.com/Houseofmvps/ultraship)
-'use strict';
-
-const { readFileSync, appendFileSync, existsSync, readdirSync, statSync, mkdirSync } = require('fs');
-const { join, relative, extname, resolve } = require('path');
-const { outputJSON, outputError } = require('./lib/output');
-
-/**
- * Formatea bytes a unidad legible.
- * @param {number} bytes
- * @returns {string}
- */
-function formatSize(bytes) {
-  if (bytes < 1024) return `${bytes}B`;
-  if (bytes < 1024 * 1024) return `${Math.round(bytes / 1024 * 10) / 10}KB`;
-  return `${Math.round(bytes / (1024 * 1024) * 10) / 10}MB`;
-}
-
-/**
- * Detecta el directorio de build de un proyecto.
- * @param {string} dir
- * @returns {{ dir: string, path: string } | null}
- */
-function findBuildOutput(dir) {
-  const candidates = ['dist', 'build', '.next', 'out', '.output', '.vercel/output'];
-  for (const d of candidates) {
-    const p = join(dir, d);
-    try {
-      if (existsSync(p) && statSync(p).isDirectory()) return { dir: d, path: p };
-    } catch { /* skip */ }
-  }
-  return null;
-}
-
-/**
- * Recorre recursivamente un directorio y devuelve archivos con las extensiones indicadas.
- * @param {string} dir
- * @param {string[]} extensions
- * @returns {{ path: string, size: number }[]}
- */
-function walkFiles(dir, extensions) {
-  const extSet = new Set(extensions.map(e => e.toLowerCase()));
-  const files = [];
-
-  function walk(d) {
-    try {
-      for (const entry of readdirSync(d)) {
-        if (entry.startsWith('.')) continue;
-        const p = join(d, entry);
-        try {
-          const s = statSync(p);
-          if (s.isDirectory()) walk(p);
-          else if (extSet.has(extname(entry).toLowerCase())) {
-            files.push({ path: p, size: s.size });
-          }
-        } catch { /* skip */ }
-      }
-    } catch { /* skip */ }
-  }
-
-  walk(dir);
-  return files;
-}
-
-/** Dependencias pesadas conocidas con estimación de tamaño y alternativas. */
-const HEAVY_DEPS = {
-  'moment': { size: '300KB+', alternative: 'dayjs (2KB)' },
-  'lodash': { size: '70KB+', alternative: 'lodash-es o imports individuales' },
-  'jquery': { size: '90KB+', alternative: 'APIs DOM nativas' },
-  'axios': { size: '30KB+', alternative: 'fetch nativo' },
-  'underscore': { size: '30KB+', alternative: 'métodos nativos de Array' },
-  'core-js': { size: '150KB+', alternative: 'polyfills específicos únicamente' },
-  'date-fns': { size: '75KB+ (completo)', alternative: 'importar solo funciones necesarias' },
-  'validator': { size: '50KB+', alternative: 'zod o comprobaciones individuales' },
-  'bluebird': { size: '80KB+', alternative: 'Promises nativas' },
-  'request': { size: '50KB+', alternative: 'fetch nativo o undici' },
-};
-
-/**
- * Analiza las dependencias del package.json en un directorio.
- * @param {string} dir
- * @returns {{ production_deps: number, dev_deps: number, heavy_deps: object[] } | null}
- */
-function analyzeDependencies(dir) {
-  const pkgPath = join(dir, 'package.json');
-  if (!existsSync(pkgPath)) return null;
-
-  let pkg;
-  try {
-    pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
-  } catch {
-    return null;
-  }
-
-  const deps = Object.keys(pkg.dependencies || {});
-  const devDeps = Object.keys(pkg.devDependencies || {});
-
-  const heavyFound = [];
-  for (const dep of deps) {
-    if (HEAVY_DEPS[dep]) {
-      heavyFound.push({
-        dependency: dep,
-        estimated_size: HEAVY_DEPS[dep].size,
-        alternative: HEAVY_DEPS[dep].alternative,
-        severity: 'medium',
-      });
-    }
-  }
-
-  return {
-    production_deps: deps.length,
-    dev_deps: devDeps.length,
-    heavy_deps: heavyFound,
-  };
-}
-
-/**
- * Lee la última entrada del historial JSONL.
- * @param {string} historyPath
- * @returns {object | null}
- */
-function readLastHistoryEntry(historyPath) {
-  if (!existsSync(historyPath)) return null;
-  try {
-    const lines = readFileSync(historyPath, 'utf8')
-      .split('\n')
-      .filter(Boolean);
-    if (lines.length === 0) return null;
-    return JSON.parse(lines[lines.length - 1]);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Agrega una entrada al historial JSONL.
- * @param {string} historyPath
- * @param {object} entry
- */
-function appendHistoryEntry(historyPath, entry) {
-  const dir = require('path').dirname(historyPath);
-  mkdirSync(dir, { recursive: true, mode: 0o700 });
-  appendFileSync(historyPath, JSON.stringify(entry) + '\n', 'utf8');
-}
-
-function main() {
-  const args = process.argv.slice(2);
-  const dir = resolve(args.find(a => !a.startsWith('--')) || process.cwd());
-  const shouldSave = args.includes('--save');
-
-  if (!existsSync(dir)) {
-    outputError(`Directorio no encontrado: ${dir}`);
-    process.exit(0);
-  }
-
-  // Historial JSONL dentro del proyecto analizado
-  const historyPath = join(dir, '.planning', 'bundles', 'history.jsonl');
-
-  const findings = [];
-
-  // ── Análisis de bundle ─────────────────────────────────────────────────────
-  const buildOutput = findBuildOutput(dir);
-  let bundleAnalysis = null;
-
-  if (buildOutput) {
-    const jsFiles  = walkFiles(buildOutput.path, ['.js', '.mjs', '.cjs']);
-    const cssFiles = walkFiles(buildOutput.path, ['.css']);
-    const imageFiles = walkFiles(buildOutput.path, ['.png', '.jpg', '.jpeg', '.gif', '.svg', '.webp', '.avif']);
-    const allFiles = walkFiles(buildOutput.path, [
-      '.js', '.mjs', '.cjs', '.css', '.html', '.htm',
-      '.json', '.map', '.png', '.jpg', '.jpeg', '.gif',
-      '.svg', '.webp', '.avif',
-    ]);
-
-    const totalJsSize    = jsFiles.reduce((s, f) => s + f.size, 0);
-    const totalCssSize   = cssFiles.reduce((s, f) => s + f.size, 0);
-    const totalImageSize = imageFiles.reduce((s, f) => s + f.size, 0);
-    const totalSize      = allFiles.reduce((s, f) => s + f.size, 0);
-
-    const sourceMaps    = allFiles.filter(f => f.path.endsWith('.map'));
-    const sourceMapSize = sourceMaps.reduce((s, f) => s + f.size, 0);
-
-    const largestJs = jsFiles
-      .sort((a, b) => b.size - a.size)
-      .slice(0, 10)
-      .map(f => ({ file: relative(dir, f.path), size: formatSize(f.size), bytes: f.size }));
-
-    bundleAnalysis = {
-      build_dir: buildOutput.dir,
-      total_size: formatSize(totalSize),
-      total_bytes: totalSize,
-      js:           { files: jsFiles.length,     size: formatSize(totalJsSize),    bytes: totalJsSize    },
-      css:          { files: cssFiles.length,    size: formatSize(totalCssSize),   bytes: totalCssSize   },
-      images:       { files: imageFiles.length,  size: formatSize(totalImageSize), bytes: totalImageSize },
-      source_maps:  { files: sourceMaps.length,  size: formatSize(sourceMapSize),  bytes: sourceMapSize  },
-      largest_js_files: largestJs,
-    };
-
-    // Advertencias de tamaño
-    if (totalJsSize > 500 * 1024) {
-      findings.push({ severity: 'high', message: `Bundle JS total es ${formatSize(totalJsSize)} — objetivo: menos de 500 KB para buen rendimiento` });
-    } else if (totalJsSize > 250 * 1024) {
-      findings.push({ severity: 'medium', message: `Bundle JS total es ${formatSize(totalJsSize)} — considera code splitting para bundles mayores de 250 KB` });
-    }
-
-    for (const f of largestJs) {
-      if (f.bytes > 200 * 1024) {
-        findings.push({ severity: 'high', message: `${f.file} pesa ${f.size} — dividir en fragmentos más pequeños con dynamic imports` });
-      }
-    }
-
-    if (sourceMaps.length > 0) {
-      findings.push({ severity: 'low', message: `${sourceMaps.length} archivos de source map (${formatSize(sourceMapSize)}) en el build — considera excluirlos del despliegue` });
-    }
-
-    const largeImages = imageFiles.filter(f => f.size > 200 * 1024);
-    if (largeImages.length > 0) {
-      findings.push({ severity: 'medium', message: `${largeImages.length} imágenes mayores de 200 KB en el build — optimizar con conversión WebP/AVIF` });
-    }
-  } else {
-    findings.push({ severity: 'info', message: 'No se encontró directorio de build (dist/, build/, .next/, out/) — ejecuta el comando de build primero' });
-  }
-
-  // ── Análisis de dependencias ───────────────────────────────────────────────
-  const depAnalysis = analyzeDependencies(dir);
-  if (depAnalysis && depAnalysis.heavy_deps.length > 0) {
-    for (const dep of depAnalysis.heavy_deps) {
-      findings.push({
-        severity: dep.severity,
-        message: `Dependencia pesada: ${dep.dependency} (~${dep.estimated_size}) — considera ${dep.alternative}`,
-      });
-    }
-  }
-
-  // ── Comparación con historial ──────────────────────────────────────────────
-  let comparison = null;
-
-  if (shouldSave) {
-    const prev = readLastHistoryEntry(historyPath);
-
-    if (prev && prev.bundle && bundleAnalysis) {
-      const diff = bundleAnalysis.total_bytes - prev.bundle.total_bytes;
-      comparison = {
-        previous_size: prev.bundle.total_size,
-        current_size:  bundleAnalysis.total_size,
-        diff_bytes:    diff,
-        diff_formatted: (diff >= 0 ? '+' : '') + formatSize(Math.abs(diff)),
-        grew:           diff > 0,
-        previous_date:  prev.timestamp,
-      };
-
-      if (diff > 50 * 1024) {
-        findings.push({ severity: 'high',   message: `Bundle creció ${formatSize(diff)} desde la última revisión — investiga nuevas dependencias o tree-shaking ausente` });
-      } else if (diff > 10 * 1024) {
-        findings.push({ severity: 'medium', message: `Bundle creció ${formatSize(diff)} desde la última revisión` });
-      }
-    }
-
-    // Persistir entrada en JSONL
-    const entry = {
-      timestamp:    new Date().toISOString(),
-      bundle:       bundleAnalysis,
-      dependencies: depAnalysis,
-      findings_count: findings.length,
-    };
-    try {
-      appendHistoryEntry(historyPath, entry);
-    } catch (err) {
-      outputError('Error al guardar historial de bundle', { message: err.message });
-    }
-  }
-
-  outputJSON({
-    success:        true,
-    packages_scanned: 1,
-    bundle:         bundleAnalysis,
-    dependencies:   depAnalysis,
-    comparison,
-    findings,
-    report_saved:   shouldSave,
-    history_path:   shouldSave ? historyPath : null,
-  });
-}
-
-if (require.main === module) {
-  main();
-}
-
-module.exports = { findBuildOutput, walkFiles, analyzeDependencies, formatSize, HEAVY_DEPS };
+// Adaptado de temp/ultraship-main/tools/bundle-tracker.mjs bajo MIT License
+// Fuente: Houseofmvps/ultraship (https://github.com/Houseofmvps/ultraship)
+'use strict';
+
+const { readFileSync, appendFileSync, existsSync, readdirSync, statSync, mkdirSync } = require('fs');
+const { join, relative, extname, resolve } = require('path');
+const { outputJSON, outputError } = require('./lib/output');
+
+/**
+ * Formatea bytes a unidad legible.
+ * @param {number} bytes
+ * @returns {string}
+ */
+function formatSize(bytes) {
+  if (bytes < 1024) return `${bytes}B`;
+  if (bytes < 1024 * 1024) return `${Math.round(bytes / 1024 * 10) / 10}KB`;
+  return `${Math.round(bytes / (1024 * 1024) * 10) / 10}MB`;
+}
+
+/**
+ * Detecta el directorio de build de un proyecto.
+ * @param {string} dir
+ * @returns {{ dir: string, path: string } | null}
+ */
+function findBuildOutput(dir) {
+  const candidates = ['dist', 'build', '.next', 'out', '.output', '.vercel/output'];
+  for (const d of candidates) {
+    const p = join(dir, d);
+    try {
+      if (existsSync(p) && statSync(p).isDirectory()) return { dir: d, path: p };
+    } catch { /* skip */ }
+  }
+  return null;
+}
+
+/**
+ * Recorre recursivamente un directorio y devuelve archivos con las extensiones indicadas.
+ * @param {string} dir
+ * @param {string[]} extensions
+ * @returns {{ path: string, size: number }[]}
+ */
+function walkFiles(dir, extensions) {
+  const extSet = new Set(extensions.map(e => e.toLowerCase()));
+  const files = [];
+
+  function walk(d) {
+    try {
+      for (const entry of readdirSync(d)) {
+        if (entry.startsWith('.')) continue;
+        const p = join(d, entry);
+        try {
+          const s = statSync(p);
+          if (s.isDirectory()) walk(p);
+          else if (extSet.has(extname(entry).toLowerCase())) {
+            files.push({ path: p, size: s.size });
+          }
+        } catch { /* skip */ }
+      }
+    } catch { /* skip */ }
+  }
+
+  walk(dir);
+  return files;
+}
+
+/** Dependencias pesadas conocidas con estimación de tamaño y alternativas. */
+const HEAVY_DEPS = {
+  'moment': { size: '300KB+', alternative: 'dayjs (2KB)' },
+  'lodash': { size: '70KB+', alternative: 'lodash-es o imports individuales' },
+  'jquery': { size: '90KB+', alternative: 'APIs DOM nativas' },
+  'axios': { size: '30KB+', alternative: 'fetch nativo' },
+  'underscore': { size: '30KB+', alternative: 'métodos nativos de Array' },
+  'core-js': { size: '150KB+', alternative: 'polyfills específicos únicamente' },
+  'date-fns': { size: '75KB+ (completo)', alternative: 'importar solo funciones necesarias' },
+  'validator': { size: '50KB+', alternative: 'zod o comprobaciones individuales' },
+  'bluebird': { size: '80KB+', alternative: 'Promises nativas' },
+  'request': { size: '50KB+', alternative: 'fetch nativo o undici' },
+};
+
+/**
+ * Analiza las dependencias del package.json en un directorio.
+ * @param {string} dir
+ * @returns {{ production_deps: number, dev_deps: number, heavy_deps: object[] } | null}
+ */
+function analyzeDependencies(dir) {
+  const pkgPath = join(dir, 'package.json');
+  if (!existsSync(pkgPath)) return null;
+
+  let pkg;
+  try {
+    pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+  } catch {
+    return null;
+  }
+
+  const deps = Object.keys(pkg.dependencies || {});
+  const devDeps = Object.keys(pkg.devDependencies || {});
+
+  const heavyFound = [];
+  for (const dep of deps) {
+    if (HEAVY_DEPS[dep]) {
+      heavyFound.push({
+        dependency: dep,
+        estimated_size: HEAVY_DEPS[dep].size,
+        alternative: HEAVY_DEPS[dep].alternative,
+        severity: 'medium',
+      });
+    }
+  }
+
+  return {
+    production_deps: deps.length,
+    dev_deps: devDeps.length,
+    heavy_deps: heavyFound,
+  };
+}
+
+/**
+ * Lee la última entrada del historial JSONL.
+ * @param {string} historyPath
+ * @returns {object | null}
+ */
+function readLastHistoryEntry(historyPath) {
+  if (!existsSync(historyPath)) return null;
+  try {
+    const lines = readFileSync(historyPath, 'utf8')
+      .split('\n')
+      .filter(Boolean);
+    if (lines.length === 0) return null;
+    return JSON.parse(lines[lines.length - 1]);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Agrega una entrada al historial JSONL.
+ * @param {string} historyPath
+ * @param {object} entry
+ */
+function appendHistoryEntry(historyPath, entry) {
+  const dir = require('path').dirname(historyPath);
+  mkdirSync(dir, { recursive: true, mode: 0o700 });
+  appendFileSync(historyPath, JSON.stringify(entry) + '\n', 'utf8');
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const dir = resolve(args.find(a => !a.startsWith('--')) || process.cwd());
+  const shouldSave = args.includes('--save');
+
+  if (!existsSync(dir)) {
+    outputError(`Directorio no encontrado: ${dir}`);
+    process.exit(0);
+  }
+
+  // Historial JSONL dentro del proyecto analizado
+  const historyPath = join(dir, '.planning', 'bundles', 'history.jsonl');
+
+  const findings = [];
+
+  // ── Análisis de bundle ─────────────────────────────────────────────────────
+  const buildOutput = findBuildOutput(dir);
+  let bundleAnalysis = null;
+
+  if (buildOutput) {
+    const jsFiles  = walkFiles(buildOutput.path, ['.js', '.mjs', '.cjs']);
+    const cssFiles = walkFiles(buildOutput.path, ['.css']);
+    const imageFiles = walkFiles(buildOutput.path, ['.png', '.jpg', '.jpeg', '.gif', '.svg', '.webp', '.avif']);
+    const allFiles = walkFiles(buildOutput.path, [
+      '.js', '.mjs', '.cjs', '.css', '.html', '.htm',
+      '.json', '.map', '.png', '.jpg', '.jpeg', '.gif',
+      '.svg', '.webp', '.avif',
+    ]);
+
+    const totalJsSize    = jsFiles.reduce((s, f) => s + f.size, 0);
+    const totalCssSize   = cssFiles.reduce((s, f) => s + f.size, 0);
+    const totalImageSize = imageFiles.reduce((s, f) => s + f.size, 0);
+    const totalSize      = allFiles.reduce((s, f) => s + f.size, 0);
+
+    const sourceMaps    = allFiles.filter(f => f.path.endsWith('.map'));
+    const sourceMapSize = sourceMaps.reduce((s, f) => s + f.size, 0);
+
+    const largestJs = jsFiles
+      .sort((a, b) => b.size - a.size)
+      .slice(0, 10)
+      .map(f => ({ file: relative(dir, f.path), size: formatSize(f.size), bytes: f.size }));
+
+    bundleAnalysis = {
+      build_dir: buildOutput.dir,
+      total_size: formatSize(totalSize),
+      total_bytes: totalSize,
+      js:           { files: jsFiles.length,     size: formatSize(totalJsSize),    bytes: totalJsSize    },
+      css:          { files: cssFiles.length,    size: formatSize(totalCssSize),   bytes: totalCssSize   },
+      images:       { files: imageFiles.length,  size: formatSize(totalImageSize), bytes: totalImageSize },
+      source_maps:  { files: sourceMaps.length,  size: formatSize(sourceMapSize),  bytes: sourceMapSize  },
+      largest_js_files: largestJs,
+    };
+
+    // Advertencias de tamaño
+    if (totalJsSize > 500 * 1024) {
+      findings.push({ severity: 'high', message: `Bundle JS total es ${formatSize(totalJsSize)} — objetivo: menos de 500 KB para buen rendimiento` });
+    } else if (totalJsSize > 250 * 1024) {
+      findings.push({ severity: 'medium', message: `Bundle JS total es ${formatSize(totalJsSize)} — considera code splitting para bundles mayores de 250 KB` });
+    }
+
+    for (const f of largestJs) {
+      if (f.bytes > 200 * 1024) {
+        findings.push({ severity: 'high', message: `${f.file} pesa ${f.size} — dividir en fragmentos más pequeños con dynamic imports` });
+      }
+    }
+
+    if (sourceMaps.length > 0) {
+      findings.push({ severity: 'low', message: `${sourceMaps.length} archivos de source map (${formatSize(sourceMapSize)}) en el build — considera excluirlos del despliegue` });
+    }
+
+    const largeImages = imageFiles.filter(f => f.size > 200 * 1024);
+    if (largeImages.length > 0) {
+      findings.push({ severity: 'medium', message: `${largeImages.length} imágenes mayores de 200 KB en el build — optimizar con conversión WebP/AVIF` });
+    }
+  } else {
+    findings.push({ severity: 'info', message: 'No se encontró directorio de build (dist/, build/, .next/, out/) — ejecuta el comando de build primero' });
+  }
+
+  // ── Análisis de dependencias ───────────────────────────────────────────────
+  const depAnalysis = analyzeDependencies(dir);
+  if (depAnalysis && depAnalysis.heavy_deps.length > 0) {
+    for (const dep of depAnalysis.heavy_deps) {
+      findings.push({
+        severity: dep.severity,
+        message: `Dependencia pesada: ${dep.dependency} (~${dep.estimated_size}) — considera ${dep.alternative}`,
+      });
+    }
+  }
+
+  // ── Comparación con historial ──────────────────────────────────────────────
+  let comparison = null;
+
+  if (shouldSave) {
+    const prev = readLastHistoryEntry(historyPath);
+
+    if (prev && prev.bundle && bundleAnalysis) {
+      const diff = bundleAnalysis.total_bytes - prev.bundle.total_bytes;
+      comparison = {
+        previous_size: prev.bundle.total_size,
+        current_size:  bundleAnalysis.total_size,
+        diff_bytes:    diff,
+        diff_formatted: (diff >= 0 ? '+' : '') + formatSize(Math.abs(diff)),
+        grew:           diff > 0,
+        previous_date:  prev.timestamp,
+      };
+
+      if (diff > 50 * 1024) {
+        findings.push({ severity: 'high',   message: `Bundle creció ${formatSize(diff)} desde la última revisión — investiga nuevas dependencias o tree-shaking ausente` });
+      } else if (diff > 10 * 1024) {
+        findings.push({ severity: 'medium', message: `Bundle creció ${formatSize(diff)} desde la última revisión` });
+      }
+    }
+
+    // Persistir entrada en JSONL
+    const entry = {
+      timestamp:    new Date().toISOString(),
+      bundle:       bundleAnalysis,
+      dependencies: depAnalysis,
+      findings_count: findings.length,
+    };
+    try {
+      appendHistoryEntry(historyPath, entry);
+    } catch (err) {
+      outputError('Error al guardar historial de bundle', { message: err.message });
+    }
+  }
+
+  outputJSON({
+    success:        true,
+    packages_scanned: 1,
+    bundle:         bundleAnalysis,
+    dependencies:   depAnalysis,
+    comparison,
+    findings,
+    report_saved:   shouldSave,
+    history_path:   shouldSave ? historyPath : null,
+  });
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = { findBuildOutput, walkFiles, analyzeDependencies, formatSize, HEAVY_DEPS };