param(

[switch]$Force,

[switch]$CI,

[switch]$NoJestCheck

)

$ErrorActionPreference = 'Stop'

if (-not (Test-Path 'package.json')) {

Write-Error 'package.json not found in current directory; run from project root.'

exit 1

}

if (-not (Get-Command node -ErrorAction SilentlyContinue)) { Write-Error 'Node.js is required but was not found. Install from https://nodejs.org/' ; exit 1 }

if (-not (Get-Command npm -ErrorAction SilentlyContinue)) { Write-Error 'npm is required but was not found (it ships with Node.js).' ; exit 1 }

$nodeVersion = (node --version) 2>$null

$npmVersion = (npm --version) 2>$null

Write-Host ("Node.js {0} / npm {1}" -f $nodeVersion,$npmVersion)

$skip = $false

if (-not $Force -and (Test-Path 'node_modules')) {

Write-Host 'node_modules already present; skipping install (use -Force to override).'

$skip = $true

}

if (-not $skip) {

Write-Host 'Installing JavaScript dependencies with npm...'

$npmArgs = @('install')

if ($CI) { $npmArgs += @('--no-fund','--no-audit') }

npm @npmArgs

Write-Host 'npm install complete.'

} else {

Write-Host 'Skipped install.'

}

if (-not $NoJestCheck) {

try {

# Use npm exec to run locally installed jest (avoids npx downloading wrong version)

$jestVersion = (npm exec jest -- --version) 2>$null

if ($LASTEXITCODE -eq 0 -and $jestVersion) {

Write-Host ("jest version: {0}" -f $jestVersion)

} else {

Write-Host 'jest not found after install (unexpected)' -ForegroundColor Yellow

# Don't fail setup just because jest version check failed

}

} catch {

Write-Host 'jest invocation failed (non-critical)' -ForegroundColor Yellow

# Don't fail setup just because jest version check failed

}

}

Write-Host '=== JavaScript setup done ==='