pnpm/exec/commands/src/makeEnv.ts

import path from 'node:path'

import { PnpmError } from '@pnpm/error'
import { prependDirsToPath } from '@pnpm/shell.path'

export interface Env extends NodeJS.ProcessEnv {
  npm_config_user_agent: string
  PATH?: string
  Path?: string
}

export function makeEnv (
  opts: {
    extraEnv?: NodeJS.ProcessEnv
    userAgent?: string
    prependPaths: string[]
  }
): Env {
  for (const prependPath of opts.prependPaths) {
    if (prependPath.includes(path.delimiter)) {
      // Unfortunately, there is no way to escape the PATH delimiter,
      // so directories added to the PATH should not contain it.
      throw new PnpmError('BAD_PATH_DIR', `Cannot add ${prependPath} to PATH because it contains the path delimiter character (${path.delimiter})`)
    }
  }
  const pathEnv = prependDirsToPath(opts.prependPaths)
  return {
    ...process.env,
    ...opts.extraEnv,
    npm_config_user_agent: opts.userAgent ?? 'pnpm',
    [pathEnv.name]: pathEnv.value,
  }
}