pnpm/exec/commands/src/runDepsStatusCheck.ts

import type { VerifyDepsBeforeRun } from '@pnpm/config.reader'
import { checkDepsStatus, type CheckDepsStatusOptions, type WorkspaceStateSettings } from '@pnpm/deps.status'
import { PnpmError } from '@pnpm/error'
import { runPnpmCli } from '@pnpm/exec.pnpm-cli-runner'
import { globalWarn } from '@pnpm/logger'
import enquirer from 'enquirer'

export interface RunDepsStatusCheckOptions extends CheckDepsStatusOptions {
  dir: string
  verifyDepsBeforeRun?: VerifyDepsBeforeRun
}

export async function runDepsStatusCheck (opts: RunDepsStatusCheckOptions): Promise<void> {
  // the following flags are always the default values during `pnpm run` and `pnpm exec`,
  // so they may not match the workspace state after `pnpm install --production|--no-optional`
  const ignoredWorkspaceStateSettings = ['dev', 'optional', 'production'] satisfies Array<keyof WorkspaceStateSettings>
  opts.ignoredWorkspaceStateSettings = ignoredWorkspaceStateSettings

  const { upToDate, issue, workspaceState } = await checkDepsStatus(opts)
  if (upToDate) return

  const command = ['install', ...createInstallArgs(workspaceState?.settings)]
  const install = runPnpmCli.bind(null, command, { cwd: opts.dir })

  switch (opts.verifyDepsBeforeRun) {
    case 'install':
      install()
      break
    case 'prompt': {
    // In non-TTY environments (like CI), we can't prompt the user
    // Exit with error to alert users that node_modules are out of sync
      if (!process.stdin.isTTY) {
        throw new PnpmError('VERIFY_DEPS_BEFORE_RUN', issue ?? 'Your node_modules are out of sync with your lockfile', {
          hint: 'Run "pnpm install" before running scripts. The "verifyDepsBeforeRun: prompt" setting cannot prompt for confirmation in non-interactive environments.',
        })
      }
      let confirmed: { runInstall: boolean }
      try {
        confirmed = await enquirer.prompt<{ runInstall: boolean }>({
          type: 'confirm',
          name: 'runInstall',
          message: `Your "node_modules" directory is out of sync with the "pnpm-lock.yaml" file. This can lead to issues during scripts execution.

Would you like to run "pnpm ${command.join(' ')}" to update your "node_modules"?`,
          initial: true,
        })
      } catch {
      // User cancelled the prompt (e.g. Ctrl+C) — exit immediately
      // so the caller doesn't proceed to run the script.
        process.exit(1)
      }
      if (confirmed.runInstall) {
        install()
      }
      break
    }
    case 'error':
      throw new PnpmError('VERIFY_DEPS_BEFORE_RUN', issue ?? 'Your node_modules are out of sync with your lockfile', {
        hint: 'Run "pnpm install"',
      })
    case 'warn':
      globalWarn(`Your node_modules are out of sync with your lockfile. ${issue}`)
      break
  }
}

export function createInstallArgs (opts: Pick<WorkspaceStateSettings, 'dev' | 'optional' | 'production'> | undefined): string[] {
  const args: string[] = []
  if (!opts) return args
  const { dev, optional, production } = opts
  if (production && !dev) {
    args.push('--production')
  } else if (dev && !production) {
    args.push('--dev')
  }
  if (!optional) {
    args.push('--no-optional')
  }
  return args
}