Function executeBinaryRemoval

src/upgrade/remove-binary.ts:263–305

(
  plan: BinaryRemovalPlan,
  deps: RemoveBinaryDeps = defaultRemoveDeps(),
)

}

export function executeBinaryRemoval(
  plan: BinaryRemovalPlan,
  deps: RemoveBinaryDeps = defaultRemoveDeps(),
): BinaryRemovalResult {
  const result: BinaryRemovalResult = { removed: [], leftovers: [], npm: 'skipped' };

  const P = pathFor(deps.platform);
  for (const p of plan.paths) {
    // Planner-emitted paths are always deep, specific artifacts; this guard
    // exists so no future planner bug can ever hand the executor a root.
    if (P.resolve(p) === P.parse(P.resolve(p)).root) {
      result.leftovers.push(p);
      continue;
    }
    try {
      deps.rm(p);
      result.removed.push(p);
    } catch {
      // Windows: the running exe inside this tree is deletable-after-rename.
      const moved = moveLockedExeAside(p, deps);
      try {
        deps.rm(p);
        result.removed.push(p);
        if (moved) result.leftovers.push(moved);
      } catch {
        result.leftovers.push(p);
      }
    }
  }

  if (plan.npmGlobal) {
    // If we are RUNNING from the npm install on Windows, npm's delete will
    // hit the same lock — move the exe aside first.
    let moved: string | null = null;
    if (plan.npmRoot) moved = moveLockedExeAside(plan.npmRoot, deps);
    const inv = npmInvocation(deps.platform, ['uninstall', '-g', NPM_PACKAGE]);
    const code = deps.run(inv.cmd, inv.args);
    result.npm = code === 0 ? 'removed' : 'failed';
    if (moved) result.leftovers.push(moved);
  }

  return result;
}