doctor.js

const cacache = require('cacache')
const chalk = require('chalk')
const fs = require('fs')
const fetch = require('make-fetch-happen')
const table = require('text-table')
const which = require('which')
const pacote = require('pacote')
const { resolve } = require('path')
const semver = require('semver')
const { promisify } = require('util')
const ansiTrim = require('./utils/ansi-trim.js')
const isWindows = require('./utils/is-windows.js')
const ping = require('./utils/ping.js')
const usageUtil = require('./utils/usage.js')
const { defaults: { registry: defaultRegistry } } = require('./utils/config.js')
const lstat = promisify(fs.lstat)
const readdir = promisify(fs.readdir)
const access = promisify(fs.access)
const { R_OK, W_OK, X_OK } = fs.constants
const maskLabel = mask => {
  const label = []
  if (mask & R_OK)
    label.push('readable')

  if (mask & W_OK)
    label.push('writable')

  if (mask & X_OK)
    label.push('executable')

  return label.join(', ')
}

class Doctor {
  constructor (npm) {
    this.npm = npm
  }

  /* istanbul ignore next - see test/lib/load-all-commands.js */
  get usage () {
    return usageUtil('doctor', 'npm doctor')
  }

  exec (args, cb) {
    this.doctor(args).then(() => cb()).catch(cb)
  }

  async doctor (args) {
    this.npm.log.info('Running checkup')

    // each message is [title, ok, message]
    const messages = []

    const actions = [
      ['npm ping', 'checkPing', []],
      ['npm -v', 'getLatestNpmVersion', []],
      ['node -v', 'getLatestNodejsVersion', []],
      ['npm config get registry', 'checkNpmRegistry', []],
      ['which git', 'getGitPath', []],
      ...(isWindows ? [] : [
        ['Perms check on cached files', 'checkFilesPermission', [this.npm.cache, true, R_OK]],
        ['Perms check on local node_modules', 'checkFilesPermission', [this.npm.localDir, true]],
        ['Perms check on global node_modules', 'checkFilesPermission', [this.npm.globalDir, false]],
        ['Perms check on local bin folder', 'checkFilesPermission', [this.npm.localBin, false, R_OK | W_OK | X_OK]],
        ['Perms check on global bin folder', 'checkFilesPermission', [this.npm.globalBin, false, X_OK]],
      ]),
      ['Verify cache contents', 'verifyCachedFiles', [this.npm.flatOptions.cache]],
      // TODO:
      // - ensure arborist.loadActual() runs without errors and no invalid edges
      // - ensure package-lock.json matches loadActual()
      // - verify loadActual without hidden lock file matches hidden lockfile
      // - verify all local packages have bins linked
    ]

    // Do the actual work
    for (const [msg, fn, args] of actions) {
      const line = [msg]
      try {
        line.push(true, await this[fn](...args))
      } catch (er) {
        line.push(false, er)
      }
      messages.push(line)
    }

    const outHead = ['Check', 'Value', 'Recommendation/Notes']
      .map(!this.npm.color ? h => h : h => chalk.underline(h))
    let allOk = true
    const outBody = messages.map(!this.npm.color
      ? item => {
        allOk = allOk && item[1]
        item[1] = item[1] ? 'ok' : 'not ok'
        item[2] = String(item[2])
        return item
      }
      : item => {
        allOk = allOk && item[1]
        if (!item[1]) {
          item[0] = chalk.red(item[0])
          item[2] = chalk.magenta(String(item[2]))
        }
        item[1] = item[1] ? chalk.green('ok') : chalk.red('not ok')
        return item
      })
    const outTable = [outHead, ...outBody]
    const tableOpts = {
      stringLength: s => ansiTrim(s).length,
    }

    const silent = this.npm.log.levels[this.npm.log.level] >
      this.npm.log.levels.error
    if (!silent) {
      this.npm.output(table(outTable, tableOpts))
      if (!allOk)
        console.error('')
    }
    if (!allOk)
      throw 'Some problems found. See above for recommendations.'
  }

  async checkPing () {
    const tracker = this.npm.log.newItem('checkPing', 1)
    tracker.info('checkPing', 'Pinging registry')
    try {
      await ping(this.npm.flatOptions)
      return ''
    } catch (er) {
      if (/^E\d{3}$/.test(er.code || ''))
        throw er.code.substr(1) + ' ' + er.message
      else
        throw er.message
    } finally {
      tracker.finish()
    }
  }

  async getLatestNpmVersion () {
    const tracker = this.npm.log.newItem('getLatestNpmVersion', 1)
    tracker.info('getLatestNpmVersion', 'Getting npm package information')
    try {
      const latest = (await pacote.manifest('npm@latest', this.npm.flatOptions)).version
      if (semver.gte(this.npm.version, latest))
        return `current: v${this.npm.version}, latest: v${latest}`
      else
        throw `Use npm v${latest}`
    } finally {
      tracker.finish()
    }
  }

  async getLatestNodejsVersion () {
    // XXX get the latest in the current major as well
    const current = process.version
    const currentRange = `^${current}`
    const url = 'https://nodejs.org/dist/index.json'
    const tracker = this.npm.log.newItem('getLatestNodejsVersion', 1)
    tracker.info('getLatestNodejsVersion', 'Getting Node.js release information')
    try {
      const res = await fetch(url, { method: 'GET', ...this.npm.flatOptions })
      const data = await res.json()
      let maxCurrent = '0.0.0'
      let maxLTS = '0.0.0'
      for (const { lts, version } of data) {
        if (lts && semver.gt(version, maxLTS))
          maxLTS = version

        if (semver.satisfies(version, currentRange) &&
          semver.gt(version, maxCurrent))
          maxCurrent = version
      }
      const recommended = semver.gt(maxCurrent, maxLTS) ? maxCurrent : maxLTS
      if (semver.gte(process.version, recommended))
        return `current: ${current}, recommended: ${recommended}`
      else
        throw `Use node ${recommended} (current: ${current})`
    } finally {
      tracker.finish()
    }
  }

  async checkFilesPermission (root, shouldOwn, mask = null) {
    if (mask === null)
      mask = shouldOwn ? R_OK | W_OK : R_OK

    let ok = true

    const tracker = this.npm.log.newItem(root, 1)

    try {
      const uid = process.getuid()
      const gid = process.getgid()
      const files = new Set([root])
      for (const f of files) {
        tracker.silly('checkFilesPermission', f.substr(root.length + 1))
        const st = await lstat(f)
          .catch(er => {
            ok = false
            tracker.warn('checkFilesPermission', 'error getting info for ' + f)
          })

        tracker.completeWork(1)

        if (!st)
          continue

        if (shouldOwn && (uid !== st.uid || gid !== st.gid)) {
          tracker.warn('checkFilesPermission', 'should be owner of ' + f)
          ok = false
        }

        if (!st.isDirectory() && !st.isFile())
          continue

        try {
          await access(f, mask)
        } catch (er) {
          ok = false
          const msg = `Missing permissions on ${f} (expect: ${maskLabel(mask)})`
          tracker.error('checkFilesPermission', msg)
          continue
        }

        if (st.isDirectory()) {
          const entries = await readdir(f)
            .catch(er => {
              ok = false
              tracker.warn('checkFilesPermission', 'error reading directory ' + f)
              return []
            })
          for (const entry of entries)
            files.add(resolve(f, entry))
        }
      }
    } finally {
      tracker.finish()
      if (!ok) {
        throw `Check the permissions of files in ${root}` +
          (shouldOwn ? ' (should be owned by current user)' : '')
      } else
        return ''
    }
  }

  async getGitPath () {
    const tracker = this.npm.log.newItem('getGitPath', 1)
    tracker.info('getGitPath', 'Finding git in your PATH')
    try {
      return await which('git').catch(er => {
        tracker.warn(er)
        throw "Install git and ensure it's in your PATH."
      })
    } finally {
      tracker.finish()
    }
  }

  async verifyCachedFiles () {
    const tracker = this.npm.log.newItem('verifyCachedFiles', 1)
    tracker.info('verifyCachedFiles', 'Verifying the npm cache')
    try {
      const stats = await cacache.verify(this.npm.flatOptions.cache)
      const {
        badContentCount,
        reclaimedCount,
        missingContent,
        reclaimedSize,
      } = stats
      if (badContentCount || reclaimedCount || missingContent) {
        if (badContentCount)
          tracker.warn('verifyCachedFiles', `Corrupted content removed: ${badContentCount}`)

        if (reclaimedCount)
          tracker.warn('verifyCachedFiles', `Content garbage-collected: ${reclaimedCount} (${reclaimedSize} bytes)`)

        if (missingContent)
          tracker.warn('verifyCachedFiles', `Missing content: ${missingContent}`)

        tracker.warn('verifyCachedFiles', 'Cache issues have been fixed')
      }
      tracker.info('verifyCachedFiles', `Verification complete. Stats: ${
      JSON.stringify(stats, null, 2)
    }`)
      return `verified ${stats.verifiedContent} tarballs`
    } finally {
      tracker.finish()
    }
  }

  async checkNpmRegistry () {
    if (this.npm.flatOptions.registry !== defaultRegistry)
      throw `Try \`npm config set registry=${defaultRegistry}\``
    else
      return `using default registry (${defaultRegistry})`
  }
}

module.exports = Doctor