@quasar/app-webpack/lib/modes/ssr/plugin.webpack.server-side.js

Quasar Framework App CLI with Webpack

/*
 * Forked from vue-server-renderer/server-plugin.js v2.6.12 NPM package
 */

const { Compilation } = require('webpack')

const jsRE = /\.js(\?[^.]+)?$/
const jsMapRE = /\.js\.map$/
const mapRE = /\.map$/

const banner = 'QuasarSSRServerPlugin'

function warn(msg) {
  console.warn(msg ? ` [warn] ${banner} ⚠️  ${msg}` : '')
}

function error(msg) {
  console.error(msg ? ` [error] ${banner} ⚠️  ${msg}` : '')
}

function extractAndValidateCompilationStats(compilation) {
  const stats = compilation.getStats().toJson()
  const entryName = Object.keys(stats.entrypoints)[0]
  const entryInfo = stats.entrypoints[entryName]
  const entryAssets = entryInfo.assets.filter(file => jsRE.test(file.name))

  if (entryAssets.length > 1) {
    throw new Error(
      'Server-side bundle should have one single entry file. ' +
        'Avoid using CommonsChunkPlugin in the server config.'
    )
  }

  const entry = entryAssets[0]
  if (!entry || typeof entry.name !== 'string') {
    throw new Error(
      'Entry "' +
        entryName +
        '" not found. Did you specify the correct entry option?'
    )
  }

  return { entry, stats }
}

module.exports.getServerDevManifest = function getServerDevManifest(
  compilation
) {
  const { entry, stats } = extractAndValidateCompilationStats(compilation)

  const serverManifest = {
    entry: entry.name,
    files: {},
    maps: {}
  }

  stats.assets.forEach(asset => {
    if (jsRE.test(asset.name)) {
      serverManifest.files[asset.name] = compilation
        .getAsset(asset.name)
        .source.source()
    } else if (asset.name.match(jsMapRE)) {
      serverManifest.maps[asset.name.replace(mapRE, '')] = JSON.parse(
        compilation.getAsset(asset.name).source.source()
      )
    }

    // do not emit anything else for server
    compilation.deleteAsset(asset.name)
  })

  return serverManifest
}

// Production only
module.exports.QuasarSSRServerPlugin = class QuasarSSRServerPlugin {
  apply(compiler) {
    if (compiler.options.target !== 'node') {
      error('webpack config `target` should be "node".')
    }

    if (
      compiler.options.output &&
      compiler.options.output.library &&
      compiler.options.output.library.type !== 'commonjs2'
    ) {
      error('webpack config `output.libraryTarget` should be "commonjs2".')
    }

    if (!compiler.options.externals) {
      warn(
        'It is recommended to externalize dependencies in the server build for ' +
          'better build performance.'
      )
    }

    compiler.hooks.thisCompilation.tap(
      'quasar-ssr-server-plugin',
      compilation => {
        compilation.hooks.processAssets.tapAsync(
          {
            name: 'quasar-ssr-server-plugin',
            state: Compilation.PROCESS_ASSETS_STAGE_ADDITIONAL
          },
          (_, callback) => {
            extractAndValidateCompilationStats(compilation)
            callback()
          }
        )
      }
    )
  }
}