Solución: Cannot find name 'process' — tipos de Node.js no instalados en TypeScript

Instala @types/node:

npm install -D @types/node

Configura tsconfig.json para incluir los tipos:

{
  "compilerOptions": {
    "types": ["node"],
    // o añádelos a lib si es necesario:
    "lib": ["ES2022"]
  }
}

Si el error persiste después de instalar:

# 1. Reinicia el servidor de TypeScript en VS Code
# Ctrl+Shift+P → "TypeScript: Restart TS Server"
# 2. Comprueba que se instaló correctamente
ls node_modules/@types/node
# 3. Borra node_modules y reinstala
rm -rf node_modules && npm install

Caso — proyecto mixto (frontend + backend en el mismo repo):

// tsconfig.json del frontend — NO incluir tipos de node (evita conflictos)
{
  "compilerOptions": {
    "lib": ["DOM", "ES2022"],
    "types": [] // excluye @types/node del frontend
  }
}
// tsconfig.node.json del backend/config
{
  "compilerOptions": {
    "types": ["node"]
  },
  "include": ["vite.config.ts", "server/**"]
}

Uso de process.env con tipos correctos en TypeScript:

// process.env devuelve string | undefined — tipado correcto:
const port = process.env.PORT ?? '3000';
const portNumber = parseInt(port, 10);
// Con validación y tipo string garantizado:
const secret = process.env.JWT_SECRET;
if (!secret) throw new Error('JWT_SECRET no definido');
// Aquí TypeScript sabe que secret es string (no undefined)
jwt.sign(payload, secret);

Tipos globales de Node.js más usados que requieren @types/node:

process        // process.env, process.exit(), process.argv
Buffer         // Buffer.from(), Buffer.alloc()
__dirname      // directorio del archivo actual (solo CJS)
__filename     // ruta del archivo actual (solo CJS)
require        // (solo CJS)
setTimeout     // versión de Node (devuelve NodeJS.Timeout, no number)