rosid/src/serve.js

'use strict'

/**
 * Serve a specified source folder.
 * @public
 * @param {Array} routes - Array of route configurations.
 * @param {String} srcPath - Path to the source folder.
 * @param {Object} opts - Additional optional options.
 * @param {Function} next - The callback that handles the response. Receives the following properties: err.
 */
module.exports = function(routes, srcPath, opts, next) {

	// Require modules on function call to speed up the initial launch
	const async    = require('async')
	const validate = require('./validate')
	const rewrite  = require('./rewrite')
	const redirect = require('./redirect')
	const deliver  = require('./deliver')

	// Make opts optional and use opts as next when next is undefined
	// Next will be validated at a later juncture
	if (next==null) next = opts

	try {

		next    = validate.next(next)
		routes  = routes.map(validate.route)
		srcPath = validate.path(srcPath)
		opts    = validate.opts(opts)

	} catch (err) {

		return next(err)

	}

	// Handlers may use promises which could lead to unhandled rejections
	process.on('unhandledRejection', next)

	const _rewrite  = rewrite(routes, srcPath)
	const _redirect = redirect()

	async.series([

		(next) => deliver(srcPath, _rewrite, _redirect, opts, next)

	], next)

}