All files collect-effects.ts

97.26% Statements 71/73
95.16% Branches 59/62
100% Functions 1/1
100% Lines 64/64

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194              6x           6x     124x         2x 2x 2x 2x                 5x     132x 131x 128x   127x         33x     34x       30x 30x           9x       124x         1x 1x               1x       37x 37x       3x 3x               3x         2x           46x 46x     5x 5x       7x 7x       24x 24x     4x 4x       5x 5x       8x 8x       3x 3x           1x           64x   7x 7x     1x 1x 1x     1x 1x 1x   55x             16x   32x 17x   1x       14x   113x 5x 108x   14x 14x      
import * as ts from 'typescript';
 
import { isFunctionLike } from './ast-helpers.js';
import { getLineAndCharacter } from './utils.js';
 
import type { TopLevelEffect } from './types.js';
 
const SYNC_IO_TOP_LEVEL = new Set([
  'readFileSync', 'writeFileSync', 'existsSync', 'mkdirSync', 'readdirSync',
  'statSync', 'lstatSync', 'unlinkSync', 'rmdirSync', 'renameSync', 'copyFileSync',
  'accessSync', 'appendFileSync', 'chmodSync', 'chownSync', 'openSync', 'closeSync',
]);
 
const EXEC_SYNC_TOP_LEVEL = new Set(['execSync', 'execFileSync', 'spawnSync']);
 
export function collectTopLevelEffects(sourceFile: ts.SourceFile, _fileRelative: string): TopLevelEffect[] {
  const effects: TopLevelEffect[] = [];
 
  for (const stmt of sourceFile.statements) {
    if (ts.isImportDeclaration(stmt)) {
      if (!stmt.importClause) {
        const spec = stmt.moduleSpecifier;
        const moduleName = ts.isStringLiteral(spec) ? spec.text : '<unknown>';
        const loc = getLineAndCharacter(sourceFile, stmt);
        effects.push({
          kind: 'side-effect-import',
          lineStart: loc.lineStart,
          lineEnd: loc.lineEnd,
          detail: `import '${moduleName}'`,
          weight: 3,
          confidence: 'medium',
        });
      }
      continue;
    }
 
    if (ts.isExportDeclaration(stmt) || ts.isExportAssignment(stmt)) continue;
    if (ts.isTypeAliasDeclaration(stmt) || ts.isInterfaceDeclaration(stmt) || ts.isEnumDeclaration(stmt)) continue;
    if (ts.isModuleDeclaration(stmt)) continue;
 
    if (isFunctionLike(stmt) || ts.isFunctionDeclaration(stmt) || ts.isClassDeclaration(stmt)) continue;
 
    if (ts.isVariableStatement(stmt)) {
      for (const decl of stmt.declarationList.declarations) {
        if (decl.initializer) {
          scanExpressionForEffects(decl.initializer, sourceFile, effects);
        }
      }
      continue;
    }
 
    if (ts.isExpressionStatement(stmt)) {
      scanExpressionForEffects(stmt.expression, sourceFile, effects);
      continue;
    }
 
    if (ts.isIfStatement(stmt) || ts.isForStatement(stmt) || ts.isWhileStatement(stmt)
        || ts.isDoStatement(stmt) || ts.isForOfStatement(stmt) || ts.isForInStatement(stmt)
        || ts.isSwitchStatement(stmt) || ts.isTryStatement(stmt)) {
      scanNodeForEffects(stmt, sourceFile, effects);
    }
  }
 
  return effects;
}
 
function scanExpressionForEffects(expr: ts.Expression, sourceFile: ts.SourceFile, effects: TopLevelEffect[]): void {
  if (ts.isAwaitExpression(expr)) {
    const loc = getLineAndCharacter(sourceFile, expr);
    effects.push({
      kind: 'top-level-await',
      lineStart: loc.lineStart,
      lineEnd: loc.lineEnd,
      detail: 'top-level await',
      weight: 4,
      confidence: 'high',
    });
    return;
  }
 
  if (ts.isCallExpression(expr)) {
    classifyCall(expr, sourceFile, effects);
    return;
  }
 
  if (ts.isNewExpression(expr) && expr.expression.getText(sourceFile) === 'Function') {
    const loc = getLineAndCharacter(sourceFile, expr);
    effects.push({
      kind: 'eval',
      lineStart: loc.lineStart,
      lineEnd: loc.lineEnd,
      detail: 'new Function()',
      weight: 8,
      confidence: 'high',
    });
    return;
  }
 
  if (ts.isBinaryExpression(expr) && expr.operatorToken.kind === ts.SyntaxKind.EqualsToken) {
    if (ts.isCallExpression(expr.right)) {
      classifyCall(expr.right, sourceFile, effects);
    }
  }
}
 
function classifyCall(call: ts.CallExpression, sourceFile: ts.SourceFile, effects: TopLevelEffect[]): void {
  const text = call.expression.getText(sourceFile);
  const loc = getLineAndCharacter(sourceFile, call);
 
  if (text === 'eval' || text === 'Function') {
    effects.push({ kind: 'eval', lineStart: loc.lineStart, lineEnd: loc.lineEnd, detail: `${text}()`, weight: 8, confidence: 'high' });
    return;
  }
 
  if (text === 'setInterval' || text === 'setTimeout') {
    effects.push({ kind: 'timer', lineStart: loc.lineStart, lineEnd: loc.lineEnd, detail: `${text}()`, weight: 4, confidence: 'high' });
    return;
  }
 
  if (ts.isPropertyAccessExpression(call.expression)) {
    const method = call.expression.name.getText(sourceFile);
    const obj = call.expression.expression.getText(sourceFile);
 
    if (EXEC_SYNC_TOP_LEVEL.has(method) || EXEC_SYNC_TOP_LEVEL.has(text)) {
      effects.push({ kind: 'exec-sync', lineStart: loc.lineStart, lineEnd: loc.lineEnd, detail: text, weight: 8, confidence: 'high' });
      return;
    }
 
    if (SYNC_IO_TOP_LEVEL.has(method)) {
      effects.push({ kind: 'sync-io', lineStart: loc.lineStart, lineEnd: loc.lineEnd, detail: text, weight: 5, confidence: 'high' });
      return;
    }
 
    if (obj === 'process' && (method === 'on' || method === 'once' || method === 'addListener')) {
      effects.push({ kind: 'process-handler', lineStart: loc.lineStart, lineEnd: loc.lineEnd, detail: `${text}()`, weight: 4, confidence: 'high' });
      return;
    }
 
    if (method === 'addEventListener' || method === 'on' || method === 'addListener') {
      effects.push({ kind: 'listener', lineStart: loc.lineStart, lineEnd: loc.lineEnd, detail: `${text}()`, weight: 4, confidence: 'medium' });
      return;
    }
  }
 
  if (ts.isCallExpression(call.expression) || text === 'import') {
    if (text.startsWith('import(') || (ts.isCallExpression(call) && call.expression.kind === ts.SyntaxKind.ImportKeyword)) {
      effects.push({ kind: 'dynamic-import', lineStart: loc.lineStart, lineEnd: loc.lineEnd, detail: 'dynamic import()', weight: 3, confidence: 'medium' });
    }
  }
}
 
function scanNodeForEffects(node: ts.Node, sourceFile: ts.SourceFile, effects: TopLevelEffect[]): void {
  Iif (isFunctionLike(node) || ts.isClassDeclaration(node)) return;
  if (ts.isCallExpression(node)) {
    classifyCall(node, sourceFile, effects);
    return;
  }
  if (ts.isAwaitExpression(node)) {
    const loc = getLineAndCharacter(sourceFile, node);
    effects.push({ kind: 'top-level-await', lineStart: loc.lineStart, lineEnd: loc.lineEnd, detail: 'top-level await', weight: 4, confidence: 'high' });
    return;
  }
  if (ts.isNewExpression(node) && node.expression.getText(sourceFile) === 'Function') {
    const loc = getLineAndCharacter(sourceFile, node);
    effects.push({ kind: 'eval', lineStart: loc.lineStart, lineEnd: loc.lineEnd, detail: 'new Function()', weight: 8, confidence: 'high' });
    return;
  }
  ts.forEachChild(node, (child) => scanNodeForEffects(child, sourceFile, effects));
}
 
// ─── Prototype Pollution Risk Sites ─────────────────────────────────────────
 
 
export function findParentBlock(node: ts.Node): ts.Block | ts.SourceFile | null {
  let current = node.parent;
  while (current) {
    if (ts.isBlock(current) || ts.isSourceFile(current)) return current;
    current = current.parent;
  }
  return null;
}
 
export function blockContainsCall(block: ts.Node, sourceFile: ts.SourceFile, callName: string): boolean {
  let found = false;
  const search = (n: ts.Node): void => {
    Iif (found) return;
    if (ts.isCallExpression(n) && n.expression.getText(sourceFile) === callName) { found = true; return; }
    ts.forEachChild(n, search);
  };
  ts.forEachChild(block, search);
  return found;
}