seogeneratorserver/tools/audit-unused.cjs

// tools/audit-unused.cjs
/* 
  Audit "unused": 
   - Fichiers injoignables depuis des entrypoints
   - Exports non référencés
   - Imports orphelins
  ⚠️ Static analysis best-effort: si tu fais des require dynamiques, DI, ou evals, ajoute un @keep pour ignorer un export:
     // @keep:export NomExport
*/

const fs = require('fs');
const path = require('path');

const ROOT = process.cwd().replace(/\\/g, '/');
const EXTS = ['.js', '.cjs', '.mjs', '.jsx'];
const IGNORE_DIRS = new Set(['node_modules', '.git', 'dist', 'build', 'out', '.next', '.vercel']);

const ENTRYPOINTS = [
  'lib/test-manual.js',
  'lib/Main.js',
].map(p => path.resolve(ROOT, p));

const files = [];
(function walk(dir) {
  for (const name of fs.readdirSync(dir, { withFileTypes: true })) {
    if (name.isDirectory()) {
      if (!IGNORE_DIRS.has(name.name)) walk(path.join(dir, name.name));
    } else {
      const ext = path.extname(name.name);
      if (EXTS.includes(ext)) files.push(path.join(dir, name.name));
    }
  }
})(ROOT);

const byNorm = new Map();
for (const f of files) byNorm.set(path.normalize(f), f);

function resolveImport(fromFile, spec) {
  // ignore packages ('openai', 'undici', etc.)
  if (!spec.startsWith('.') && !spec.startsWith('/')) return null;
  const base = path.resolve(path.dirname(fromFile), spec);
  const candidates = [
    base,
    base + '.js', base + '.cjs', base + '.mjs', base + '.jsx',
    path.join(base, 'index.js'), path.join(base, 'index.cjs'), path.join(base, 'index.mjs'),
  ];
  for (const c of candidates) {
    const n = path.normalize(c);
    if (byNorm.has(n)) return byNorm.get(n);
  }
  return null;
}

const RE = {
  // imports
  require: /require\s*\(\s*['"`]([^'"`]+)['"`]\s*\)/g,
  importFrom: /import\s+[^'"]+\s+from\s+['"`]([^'"`]+)['"`]/g,
  importOnly: /import\s+['"`]([^'"`]+)['"`]\s*;?/g,

  // exports CJS
  moduleExportsObj: /module\.exports\s*=\s*{([\s\S]*?)}/g,
  moduleExportsAssign: /module\.exports\.(\w+)\s*=/g,
  exportsAssign: /exports\.(\w+)\s*=/g,

  // exports ESM
  exportNamed: /export\s+(?:const|let|var|function|class)\s+(\w+)/g,
  exportList: /export\s*{\s*([^}]+)\s*}/g,

  // usage of members
  // const { a, b } = require('./m'); import { a } from './m'
  destructured: /(?:const|let|var|import)\s*{([^}]+)}\s*=\s*(?:require\(|from\s+['"`])/g,
  // require('./m').foo  OR  (await import('./m')).foo
  dotUse: /(?:require\(\s*['"`][^'"`]+['"`]\s*\)|import\(\s*['"`][^'"`]+['"`]\s*\))\.(\w+)/g,

  keep: /@keep:export\s+(\w+)/g,
};

function parseFile(file) {
  const txt = fs.readFileSync(file, 'utf8');

  const imports = [];
  for (const rx of [RE.require, RE.importFrom, RE.importOnly]) {
    let m; while ((m = rx.exec(txt))) imports.push(m[1]);
  }

  const exports = new Set();
  const keep = new Set();

  // CJS object export
  let m;
  while ((m = RE.moduleExportsObj.exec(txt))) {
    const inside = m[1];
    inside.split(',').forEach(p => {
      const n = (p.split(':')[0] || '').trim().replace(/\s+/g, '');
      if (n) exports.add(n);
    });
  }
  while ((m = RE.moduleExportsAssign.exec(txt))) exports.add(m[1]);
  while ((m = RE.exportsAssign.exec(txt))) exports.add(m[1]);

  // ESM named
  while ((m = RE.exportNamed.exec(txt))) exports.add(m[1]);
  while ((m = RE.exportList.exec(txt))) {
    m[1].split(',').forEach(s => {
      const n = s.split(' as ')[0].trim();
      if (n) exports.add(n);
    });
  }

  while ((m = RE.keep.exec(txt))) keep.add(m[1]);

  return { file, txt, imports, exports: [...exports], keep: [...keep] };
}

const parsed = files.map(parseFile);

// Build edges
const edges = new Map(); // from -> Set(to)
const importMap = new Map(); // from -> [{raw, resolved}]
for (const p of parsed) {
  const tos = new Set();
  const details = [];
  for (const spec of p.imports) {
    const resolved = resolveImport(p.file, spec);
    if (resolved) tos.add(resolved);
    details.push({ raw: spec, resolved });
  }
  edges.set(p.file, tos);
  importMap.set(p.file, details);
}

// Reachability from entrypoints
const reachable = new Set();
function dfs(start) {
  const stack = [start];
  while (stack.length) {
    const f = stack.pop();
    if (!byNorm.has(path.normalize(f))) continue;
    if (reachable.has(f)) continue;
    reachable.add(f);
    const tos = edges.get(f) || new Set();
    tos.forEach(t => stack.push(t));
  }
}
ENTRYPOINTS.forEach(dfs);

// Usage of exports (very simple heuristic)
const exportIndex = new Map(); // file -> Set(exportName)
parsed.forEach(p => exportIndex.set(p.file, new Set(p.exports)));

const used = new Map(); // file -> Set(usedName)
for (const p of parsed) {
  const txt = p.txt;

  // destructured usage
  let m;
  while ((m = RE.destructured.exec(txt))) {
    const names = m[1].split(',').map(s => s.split(':')[0].trim());
    names.forEach(n => {
      if (!n) return;
      // mark globally; we can't know which file exactly (static pass), will map later by imports
    });
  }

  // dot usage; we can't resolve to a file reliably; will do name-only aggregation
}

function collectImportedNames(file) {
  // Return map: targetFile -> Set(names)
  const res = new Map();
  const txt = fs.readFileSync(file, 'utf8');

  // import {a,b} from './x'
  const importNamed = /import\s*{([^}]+)}\s*from\s*['"`]([^'"`]+)['"`]/g;
  let m;
  while ((m = importNamed.exec(txt))) {
    const names = m[1].split(',').map(s => s.split(' as ')[0].trim()).filter(Boolean);
    const target = resolveImport(file, m[2]);
    if (target) {
      if (!res.has(target)) res.set(target, new Set());
      names.forEach(n => res.get(target).add(n));
    }
  }

  // const {a,b} = require('./x')
  const reqNamed = /(?:const|let|var)\s*{([^}]+)}\s*=\s*require\(\s*['"`]([^'"`]+)['"`]\s*\)/g;
  while ((m = reqNamed.exec(txt))) {
    const names = m[1].split(',').map(s => s.split(':')[0].trim()).filter(Boolean);
    const target = resolveImport(file, m[2]);
    if (target) {
      if (!res.has(target)) res.set(target, new Set());
      names.forEach(n => res.get(target).add(n));
    }
  }

  // require('./x').foo
  const reqDot = /require\(\s*['"`]([^'"`]+)['"`]\s*\)\.(\w+)/g;
  while ((m = reqDot.exec(txt))) {
    const target = resolveImport(file, m[1]);
    const name = m[2];
    if (target) {
      if (!res.has(target)) res.set(target, new Set());
      res.get(target).add(name);
    }
  }

  // (await import('./x')).foo  OR  import('./x').then(m=>m.foo)
  const impDot = /import\(\s*['"`]([^'"`]+)['"`]\s*\)\.(\w+)/g;
  while ((m = impDot.exec(txt))) {
    const target = resolveImport(file, m[1]);
    const name = m[2];
    if (target) {
      if (!res.has(target)) res.set(target, new Set());
      res.get(target).add(name);
    }
  }

  return res;
}

const usageByTarget = new Map(); // targetFile -> Set(namesUsed)
for (const p of parsed) {
  const m = collectImportedNames(p.file);
  for (const [target, names] of m) {
    if (!usageByTarget.has(target)) usageByTarget.set(target, new Set());
    names.forEach(n => usageByTarget.get(target).add(n));
  }
}

function rel(p) { return path.relative(ROOT, p).replace(/\\/g, '/'); }

const report = {
  entrypoints: ENTRYPOINTS.filter(fs.existsSync).map(rel),
  unreachableFiles: [],
  brokenImports: [],
  unusedExports: [],
};

for (const f of files) {
  if (!reachable.has(f) && !ENTRYPOINTS.includes(f)) {
    report.unreachableFiles.push(rel(f));
  }
}

for (const [from, list] of importMap) {
  for (const { raw, resolved } of list) {
    if ((raw.startsWith('.') || raw.startsWith('/')) && !resolved) {
      report.brokenImports.push({ from: rel(from), spec: raw });
    }
  }
}

for (const p of parsed) {
  const exp = exportIndex.get(p.file);
  if (!exp || exp.size === 0) continue;

  const usedSet = usageByTarget.get(p.file) || new Set();
  const keepMarks = new Set(p.keep || []);

  const unused = [...exp].filter(n => !usedSet.has(n) && !keepMarks.has(n));
  if (unused.length > 0) {
    report.unusedExports.push({ file: rel(p.file), unused });
  }
}

console.log('=== UNUSED AUDIT REPORT ===');
console.log('');
console.log('Entrypoints:', report.entrypoints);
console.log('');

console.log('— Unreachable files (dead):');
if (report.unreachableFiles.length === 0) console.log('  ✔ none');
else report.unreachableFiles.sort().forEach(f => console.log('  •', f));
console.log('');

console.log('— Broken relative imports:');
if (report.brokenImports.length === 0) console.log('  ✔ none');
else report.brokenImports.forEach(i => console.log(`  • ${i.from} -> ${i.spec}`));
console.log('');

console.log('— Unused exports:');
if (report.unusedExports.length === 0) console.log('  ✔ none');
else report.unusedExports
  .sort((a,b)=>a.file.localeCompare(b.file))
  .forEach(r => console.log(`  • ${r.file}: ${r.unused.join(', ')}`));

console.log('');
console.log('Tip: ajoute un commentaire "@keep:export Nom" au-dessus d’un export pour le protéger des faux positifs.');