aboutsummaryrefslogblamecommitdiffhomepage
path: root/server/lib/plugins/yarn.ts
blob: 5fe1c50463d0f30aafd9d567f7a186a9896a6a1b (plain) (tree)
1
2
3
4
5
6
7
8
9
10






                                                                                                    
                                                                  

                                 



                                                 
 















































                                                                                           
import { execShell } from '../../helpers/core-utils'
import { logger } from '../../helpers/logger'
import { isNpmPluginNameValid, isPluginVersionValid } from '../../helpers/custom-validators/plugins'
import { CONFIG } from '../../initializers/config'
import { outputJSON, pathExists } from 'fs-extra'
import { join } from 'path'

async function installNpmPlugin (name: string, version?: string) {
  // Security check
  checkNpmPluginNameOrThrow(name)
  if (version) checkPluginVersionOrThrow(version)

  let toInstall = name
  if (version) toInstall += `@${version}`

  await execYarn('add ' + toInstall)
}

async function installNpmPluginFromDisk (path: string) {
  await execYarn('add file:' + path)
}

async function removeNpmPlugin (name: string) {
  checkNpmPluginNameOrThrow(name)

  await execYarn('remove ' + name)
}

// ############################################################################

export {
  installNpmPlugin,
  installNpmPluginFromDisk,
  removeNpmPlugin
}

// ############################################################################

async function execYarn (command: string) {
  try {
    const pluginDirectory = CONFIG.STORAGE.PLUGINS_DIR
    const pluginPackageJSON = join(pluginDirectory, 'package.json')

    // Create empty package.json file if needed
    if (!await pathExists(pluginPackageJSON)) {
      await outputJSON(pluginPackageJSON, {})
    }

    await execShell(`yarn ${command}`, { cwd: pluginDirectory })
  } catch (result) {
    logger.error('Cannot exec yarn.', { command, err: result.err, stderr: result.stderr })

    throw result.err
  }
}

function checkNpmPluginNameOrThrow (name: string) {
  if (!isNpmPluginNameValid(name)) throw new Error('Invalid NPM plugin name to install')
}

function checkPluginVersionOrThrow (name: string) {
  if (!isPluginVersionValid(name)) throw new Error('Invalid NPM plugin version to install')
}