@visa/cli 2.0.0-rc.10 → 2.0.0-rc.11

package/install.ps1

@@ -123,15 +123,44 @@ try {
     exit 1
 }
 
+# Check npm separately. Some Windows installs expose node before a refreshed
+# shell can find npm, and npm failures are much easier to fix when called out.
+try {
+    $npmVersionOutput = (& npm --version 2>$null | Select-Object -First 1)
+    if ($LASTEXITCODE -ne 0 -or -not $npmVersionOutput) { throw "not found" }
+    Write-Host "  [OK] npm $($npmVersionOutput.Trim())" -ForegroundColor Green
+} catch {
+    Write-Host "  npm is required but was not found." -ForegroundColor Red
+    Write-Host "  Install Node.js from https://nodejs.org/, close and reopen PowerShell, then try again." -ForegroundColor Yellow
+    Wait-BeforeExit
+    exit 1
+}
+
 # Install via npm
 Write-Host "  Running: npm install -g @visa/cli" -ForegroundColor Gray
-& npm install -g @visa/cli 2>&1 | Out-Host
+$npmOutput = & npm install -g @visa/cli 2>&1
+$npmExitCode = $LASTEXITCODE
+$npmText = ($npmOutput | Out-String)
+$npmOutput | Out-Host
 
-if ($LASTEXITCODE -ne 0) {
+if ($npmExitCode -ne 0) {
     Write-Host ""
-    Write-Host "  npm install failed (exit code $LASTEXITCODE)." -ForegroundColor Red
-    Write-Host "  Try running PowerShell as Administrator, or run manually:" -ForegroundColor Yellow
-    Write-Host "    npm install -g @visa/cli" -ForegroundColor Yellow
+    Write-Host "  npm install failed (exit code $npmExitCode)." -ForegroundColor Red
+
+    if ($npmText -match 'Access is denied|EACCES|EPERM|permission denied') {
+        Write-Host "  Permission problem detected. Prefer a user-scoped npm prefix before using Administrator PowerShell:" -ForegroundColor Yellow
+        Write-Host '    mkdir "$env:USERPROFILE\.npm-global"' -ForegroundColor Yellow
+        Write-Host '    npm config set prefix "$env:USERPROFILE\.npm-global"' -ForegroundColor Yellow
+        Write-Host '    [Environment]::SetEnvironmentVariable("Path", "$env:USERPROFILE\.npm-global;$env:Path", "User")' -ForegroundColor Yellow
+        Write-Host "  Then close and reopen PowerShell and rerun this installer." -ForegroundColor Yellow
+    } elseif ($npmText -match 'UNABLE_TO_GET_ISSUER_CERT_LOCALLY|SELF_SIGNED_CERT_IN_CHAIN|CERT_HAS_EXPIRED|unable to verify') {
+        Write-Host "  Certificate/proxy problem detected. If you are on a corporate network, use a personal network or ask IT for the npm certificate configuration." -ForegroundColor Yellow
+        Write-Host "  Do not disable TLS verification globally." -ForegroundColor Yellow
+    } else {
+        Write-Host "  Run manually for the full error, then retry:" -ForegroundColor Yellow
+        Write-Host "    npm install -g @visa/cli" -ForegroundColor Yellow
+    }
+
     Wait-BeforeExit
     exit 1
 }
@@ -158,10 +187,12 @@ Write-Host ""
 if ($verifiedCommand) {
     Write-Host "  Visa CLI $visaVersion installed." -ForegroundColor Green
     Write-Host "  Run '$verifiedCommand setup' to get started." -ForegroundColor Cyan
+    Write-Host "  After setup, run /mcp inside Claude Code, not PowerShell, if Claude Code was already open." -ForegroundColor Cyan
     Write-Host ""
 } else {
     $primaryCommand = $cliCommandNames | Select-Object -First 1
     Write-Host "  Installed but '$primaryCommand' was not runnable from PATH yet." -ForegroundColor Yellow
     Write-Host "  Close and reopen PowerShell, then run: $primaryCommand setup" -ForegroundColor Yellow
+    Write-Host "  Run /mcp inside Claude Code after setup if you need to reconnect the MCP server." -ForegroundColor Yellow
     Write-Host ""
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visa/cli",
-  "version": "2.0.0-rc.10",
+  "version": "2.0.0-rc.11",
   "description": "AI-powered payments for Claude Code",
   "bin": {
     "visa-cli": "./bin/visa-cli.js"