Function getEnvForPackageManager

packages/build-utils/src/fs/run-user-scripts.ts:997–1092

({
  cliType,
  lockfileVersion,
  packageJsonPackageManager,
  env,
  packageJsonEngines,
  turboSupportsCorepackHome,
  projectCreatedAt,
}: {
  cliType: CliType;
  lockfileVersion: number | undefined;
  packageJsonPackageManager?: string | undefined;
  env: { [x: string]: string | undefined };
  packageJsonEngines?: PackageJson.Engines;
  turboSupportsCorepackHome?: boolean | undefined;
  projectCreatedAt?: number | undefined;
})

 * versions.
 */
export function getEnvForPackageManager({
  cliType,
  lockfileVersion,
  packageJsonPackageManager,
  env,
  packageJsonEngines,
  turboSupportsCorepackHome,
  projectCreatedAt,
}: {
  cliType: CliType;
  lockfileVersion: number | undefined;
  packageJsonPackageManager?: string | undefined;
  env: { [x: string]: string | undefined };
  packageJsonEngines?: PackageJson.Engines;
  turboSupportsCorepackHome?: boolean | undefined;
  projectCreatedAt?: number | undefined;
}) {
  const corepackEnabled = usingCorepack(
    env,
    packageJsonPackageManager,
    turboSupportsCorepackHome
  );

  const {
    detectedLockfile,
    detectedPackageManager,
    path: newPath,
  } = getPathOverrideForPackageManager({
    cliType,
    lockfileVersion,
    corepackPackageManager: packageJsonPackageManager,
    corepackEnabled,
    packageJsonEngines,
    projectCreatedAt,
  });

  if (corepackEnabled) {
    debug(
      `Detected corepack use for "${packageJsonPackageManager}". Not overriding package manager version.`
    );
  } else {
    debug(
      `Detected ${detectedPackageManager}. Added "${newPath}" to path. Based on assumed package manager "${cliType}", lockfile "${detectedLockfile}", and lockfileVersion "${lockfileVersion}"`
    );
  }

  const newEnv: { [x: string]: string | undefined } = {
    ...env,
  };

  const alreadyInPath = (newPath: string) => {
    const oldPath = env.PATH ?? '';
    return oldPath.split(path.delimiter).includes(newPath);
  };

  if (newPath && !alreadyInPath(newPath)) {
    // Ensure that the binaries of the detected package manager are at the
    // beginning of the `$PATH`.