'use strict' const path = require('path') const url = require('url') const arrayify = require('array-back') /** * @module local-web-server */ module.exports = localWebServer /** * Returns a Koa application you can launch or mix into an existing app. * * @param [options] {object} - options * @param [options.static] {object} - koa-static config * @param [options.static.root=.] {string} - root directory * @param [options.static.options] {string} - [options](https://github.com/koajs/static#options) * @param [options.serveIndex] {object} - koa-serve-index config * @param [options.serveIndex.path=.] {string} - root directory * @param [options.serveIndex.options] {string} - [options](https://github.com/expressjs/serve-index#options) * @param [options.forbid] {string[]} - A list of forbidden routes, each route being an [express route-path](http://expressjs.com/guide/routing.html#route-paths). * @param [options.spa] {string} - specify an SPA file to catch requests for everything but static assets. * @param [options.log] {object} - [morgan](https://github.com/expressjs/morgan) config * @param [options.log.format] {string} - [log format](https://github.com/expressjs/morgan#predefined-formats) * @param [options.log.options] {object} - [options](https://github.com/expressjs/morgan#options) * @param [options.compress] {boolean} - Serve gzip-compressed resources, where applicable * @param [options.mime] {object} - A list of mime-type overrides, passed directly to [mime.define()](https://github.com/broofa/node-mime#mimedefine) * @param [options.rewrite] {module:local-web-server~rewriteRule[]} - One or more rewrite rules * @param [options.verbose] {boolean} - Print detailed output, useful for debugging * * @alias module:local-web-server * @return {external:KoaApplication} * @example * const localWebServer = require('local-web-server') * localWebServer().listen(8000) */ function localWebServer (options) { options = Object.assign({ static: {}, serveIndex: {}, spa: null, log: {}, compress: false, mime: {}, forbid: [], rewrite: [], verbose: false, mocks: [] }, options) if (options.verbose) { process.env.DEBUG = '*' } const log = options.log log.options = log.options || {} if (options.verbose && !log.format) { log.format = 'none' } if (!options.static.root) options.static.root = process.cwd() if (!options.serveIndex.path) options.serveIndex.path = process.cwd() options.rewrite = arrayify(options.rewrite) options.forbid = arrayify(options.forbid) options.mocks = arrayify(options.mocks) const debug = require('debug')('local-web-server') const Koa = require('koa') const convert = require('koa-convert') const cors = require('kcors') const _ = require('koa-route') const json = require('koa-json') const bodyParser = require('koa-bodyparser') const mw = require('./middleware') let middlewares = [] // const app = new Koa() // const _use = app.use // app.use = x => _use.call(app, convert(x)) /* CORS: allow from any origin */ // app.use(cors()) middlewares.push(cors()) /* pretty print JSON */ // app.use(json()) middlewares.push(json()) /* rewrite rules */ if (options.rewrite && options.rewrite.length) { options.rewrite.forEach(route => { if (route.to) { /* `to` address is remote if the url specifies a host */ if (url.parse(route.to).host) { debug('proxy rewrite', `${route.from} -> ${route.to}`) // app.use(_.all(route.from, mw.proxyRequest(route))) middlewares.push(_.all(route.from, mw.proxyRequest(route))) } else { const rewrite = require('koa-rewrite') const rmw = rewrite(route.from, route.to) rmw._name = 'rewrite' // app.use(rmw) middlewares.push(rmw) } } }) } /* must come after rewrite. See https://github.com/nodejitsu/node-http-proxy/issues/180. */ // app.use(bodyParser()) middlewares.push(bodyParser()) /* path blacklist */ if (options.forbid.length) { debug('forbid', options.forbid.join(', ')) // app.use(mw.blacklist(options.forbid)) middlewares.push(mw.blacklist(options.forbid)) } /* cache */ if (!options['no-cache']) { const conditional = require('koa-conditional-get') const etag = require('koa-etag') // app.use(conditional()) // app.use(etag()) middlewares.push(conditional()) middlewares.push(etag()) } /* mime-type overrides */ if (options.mime) { debug('mime override', JSON.stringify(options.mime)) // app.use(mw.mime(options.mime)) middlewares.push(mw.mime(options.mime)) } /* compress response */ if (options.compress) { const compress = require('koa-compress') debug('compression', 'enabled') // app.use(compress()) middlewares.push(compress()) } /* Logging */ if (log.format !== 'none') { const morgan = require('koa-morgan') if (!log.format) { const streamLogStats = require('stream-log-stats') log.options.stream = streamLogStats({ refreshRate: 500 }) // app.use(morgan('common', log.options)) middlewares.push(morgan('common', log.options)) } else if (log.format === 'logstalgia') { morgan.token('date', logstalgiaDate) // app.use(morgan('combined', log.options)) middlewares.push(morgan('combined', log.options)) } else { // app.use(morgan(log.format, log.options)) middlewares.push(morgan(log.format, log.options)) } } /* Mock Responses */ options.mocks.forEach(mock => { if (mock.module) { mock.responses = require(path.resolve(path.join(options.static.root, mock.module))) } if (mock.responses) { // app.use(mw.mockResponses(mock.route, mock.responses)) middlewares.push(mw.mockResponses(mock.route, mock.responses)) } else if (mock.response) { mock.target = { request: mock.request, response: mock.response } // app.use(mw.mockResponses(mock.route, mock.target)) middlewares.push(mw.mockResponses(mock.route, mock.target)) } }) /* for any URL not matched by static (e.g. `/search`), serve the SPA */ if (options.spa) { const historyApiFallback = require('koa-connect-history-api-fallback') debug('SPA', options.spa) // app.use(historyApiFallback({ // index: options.spa, // verbose: options.verbose // })) middlewares.push(historyApiFallback({ index: options.spa, verbose: options.verbose })) } /* serve static files */ if (options.static.root) { const serve = require('koa-static') // app.use(serve(options.static.root, options.static.options)) middlewares.push(serve(options.static.root, options.static.options)) } /* serve directory index */ if (options.serveIndex.path) { const serveIndex = require('koa-serve-index') // app.use(serveIndex(options.serveIndex.path, options.serveIndex.options)) middlewares.push(serveIndex(options.serveIndex.path, options.serveIndex.options)) } const compose = require('koa-compose') middlewares = middlewares.map(convert) return compose(middlewares) } function logstalgiaDate () { var d = new Date() return (`${d.getDate()}/${d.getUTCMonth()}/${d.getFullYear()}:${d.toTimeString()}`).replace('GMT', '').replace(' (BST)', '') } process.on('unhandledRejection', (reason, p) => { throw reason }) /** * The `from` and `to` routes are specified using [express route-paths](http://expressjs.com/guide/routing.html#route-paths) * * @example * ```json * { * "rewrite": [ * { "from": "/css/*", "to": "/build/styles/$1" }, * { "from": "/npm/*", "to": "http://registry.npmjs.org/$1" }, * { "from": "/:user/repos/:name", "to": "https://api.github.com/repos/:user/:name" } * ] * } * ``` * * @typedef rewriteRule * @property from {string} - request route * @property to {string} - target route */ /** * @external KoaApplication * @see https://github.com/koajs/koa/blob/master/docs/api/index.md#application */