Backend half

SerpentRace_Backend/node_modules/express/lib/application.js

@@ -14,24 +14,29 @@
  */
 
 var finalhandler = require('finalhandler');
+var Router = require('./router');
+var methods = require('methods');
+var middleware = require('./middleware/init');
+var query = require('./middleware/query');
 var debug = require('debug')('express:application');
 var View = require('./view');
-var http = require('node:http');
-var methods = require('./utils').methods;
+var http = require('http');
 var compileETag = require('./utils').compileETag;
 var compileQueryParser = require('./utils').compileQueryParser;
 var compileTrust = require('./utils').compileTrust;
-var resolve = require('node:path').resolve;
-var once = require('once')
-var Router = require('router');
+var deprecate = require('depd')('express');
+var flatten = require('array-flatten');
+var merge = require('utils-merge');
+var resolve = require('path').resolve;
+var setPrototypeOf = require('setprototypeof')
 
 /**
  * Module variables.
  * @private
  */
 
+var hasOwnProperty = Object.prototype.hasOwnProperty
 var slice = Array.prototype.slice;
-var flatten = Array.prototype.flat;
 
 /**
  * Application prototype.
@@ -57,29 +62,11 @@ var trustProxyDefaultSymbol = '@@symbol:trust_proxy_default';
  */
 
 app.init = function init() {
-  var router = null;
-
-  this.cache = Object.create(null);
-  this.engines = Object.create(null);
-  this.settings = Object.create(null);
+  this.cache = {};
+  this.engines = {};
+  this.settings = {};
 
   this.defaultConfiguration();
-
-  // Setup getting to lazily add base router
-  Object.defineProperty(this, 'router', {
-    configurable: true,
-    enumerable: true,
-    get: function getrouter() {
-      if (router === null) {
-        router = new Router({
-          caseSensitive: this.enabled('case sensitive routing'),
-          strict: this.enabled('strict routing')
-        });
-      }
-
-      return router;
-    }
-  });
 };
 
 /**
@@ -94,7 +81,7 @@ app.defaultConfiguration = function defaultConfiguration() {
   this.enable('x-powered-by');
   this.set('etag', 'weak');
   this.set('env', env);
-  this.set('query parser', 'simple')
+  this.set('query parser', 'extended');
   this.set('subdomain offset', 2);
   this.set('trust proxy', false);
 
@@ -115,10 +102,10 @@ app.defaultConfiguration = function defaultConfiguration() {
     }
 
     // inherit protos
-    Object.setPrototypeOf(this.request, parent.request)
-    Object.setPrototypeOf(this.response, parent.response)
-    Object.setPrototypeOf(this.engines, parent.engines)
-    Object.setPrototypeOf(this.settings, parent.settings)
+    setPrototypeOf(this.request, parent.request)
+    setPrototypeOf(this.response, parent.response)
+    setPrototypeOf(this.engines, parent.engines)
+    setPrototypeOf(this.settings, parent.settings)
   });
 
   // setup locals
@@ -138,6 +125,32 @@ app.defaultConfiguration = function defaultConfiguration() {
   if (env === 'production') {
     this.enable('view cache');
   }
+
+  Object.defineProperty(this, 'router', {
+    get: function() {
+      throw new Error('\'app.router\' is deprecated!\nPlease see the 3.x to 4.x migration guide for details on how to update your app.');
+    }
+  });
+};
+
+/**
+ * lazily adds the base router if it has not yet been added.
+ *
+ * We cannot add the base router in the defaultConfiguration because
+ * it reads app settings which might be set after that has run.
+ *
+ * @private
+ */
+app.lazyrouter = function lazyrouter() {
+  if (!this._router) {
+    this._router = new Router({
+      caseSensitive: this.enabled('case sensitive routing'),
+      strict: this.enabled('strict routing')
+    });
+
+    this._router.use(query(this.get('query parser fn')));
+    this._router.use(middleware.init(this));
+  }
 };
 
 /**
@@ -150,31 +163,22 @@ app.defaultConfiguration = function defaultConfiguration() {
  */
 
 app.handle = function handle(req, res, callback) {
+  var router = this._router;
+
   // final handler
   var done = callback || finalhandler(req, res, {
     env: this.get('env'),
     onerror: logerror.bind(this)
   });
 
-  // set powered by header
-  if (this.enabled('x-powered-by')) {
-    res.setHeader('X-Powered-By', 'Express');
+  // no routes
+  if (!router) {
+    debug('no routes defined on app');
+    done();
+    return;
   }
 
-  // set circular references
-  req.res = res;
-  res.req = req;
-
-  // alter the prototypes
-  Object.setPrototypeOf(req, this.request)
-  Object.setPrototypeOf(res, this.response)
-
-  // setup locals
-  if (!res.locals) {
-    res.locals = Object.create(null);
-  }
-
-  this.router.handle(req, res, done);
+  router.handle(req, res, done);
 };
 
 /**
@@ -207,14 +211,15 @@ app.use = function use(fn) {
     }
   }
 
-  var fns = flatten.call(slice.call(arguments, offset), Infinity);
+  var fns = flatten(slice.call(arguments, offset));
 
   if (fns.length === 0) {
     throw new TypeError('app.use() requires a middleware function')
   }
 
-  // get router
-  var router = this.router;
+  // setup router
+  this.lazyrouter();
+  var router = this._router;
 
   fns.forEach(function (fn) {
     // non-express app
@@ -230,8 +235,8 @@ app.use = function use(fn) {
     router.use(path, function mounted_app(req, res, next) {
       var orig = req.app;
       fn.handle(req, res, function (err) {
-        Object.setPrototypeOf(req, orig.request)
-        Object.setPrototypeOf(res, orig.response)
+        setPrototypeOf(req, orig.request)
+        setPrototypeOf(res, orig.response)
         next(err);
       });
     });
@@ -254,7 +259,8 @@ app.use = function use(fn) {
  */
 
 app.route = function route(path) {
-  return this.router.route(path);
+  this.lazyrouter();
+  return this._router.route(path);
 };
 
 /**
@@ -320,6 +326,8 @@ app.engine = function engine(ext, fn) {
  */
 
 app.param = function param(name, fn) {
+  this.lazyrouter();
+
   if (Array.isArray(name)) {
     for (var i = 0; i < name.length; i++) {
       this.param(name[i], fn);
@@ -328,7 +336,7 @@ app.param = function param(name, fn) {
     return this;
   }
 
-  this.router.param(name, fn);
+  this._router.param(name, fn);
 
   return this;
 };
@@ -351,7 +359,17 @@ app.param = function param(name, fn) {
 app.set = function set(setting, val) {
   if (arguments.length === 1) {
     // app.get(setting)
-    return this.settings[setting];
+    var settings = this.settings
+
+    while (settings && settings !== Object.prototype) {
+      if (hasOwnProperty.call(settings, setting)) {
+        return settings[setting]
+      }
+
+      settings = Object.getPrototypeOf(settings)
+    }
+
+    return undefined
   }
 
   debug('set "%s" to %o', setting, val);
@@ -468,14 +486,16 @@ app.disable = function disable(setting) {
  * Delegate `.VERB(...)` calls to `router.VERB(...)`.
  */
 
-methods.forEach(function (method) {
-  app[method] = function (path) {
+methods.forEach(function(method){
+  app[method] = function(path){
     if (method === 'get' && arguments.length === 1) {
       // app.get(setting)
       return this.set(path);
     }
 
-    var route = this.route(path);
+    this.lazyrouter();
+
+    var route = this._router.route(path);
     route[method].apply(route, slice.call(arguments, 1));
     return this;
   };
@@ -492,7 +512,9 @@ methods.forEach(function (method) {
  */
 
 app.all = function all(path) {
-  var route = this.route(path);
+  this.lazyrouter();
+
+  var route = this._router.route(path);
   var args = slice.call(arguments, 1);
 
   for (var i = 0; i < methods.length; i++) {
@@ -502,6 +524,10 @@ app.all = function all(path) {
   return this;
 };
 
+// del -> delete alias
+
+app.del = deprecate.function(app.delete, 'app.del: Use app.delete instead');
+
 /**
  * Render the given view `name` name with `options`
  * and a callback accepting an error and the
@@ -524,6 +550,7 @@ app.render = function render(name, options, callback) {
   var done = callback;
   var engines = this.engines;
   var opts = options;
+  var renderOptions = {};
   var view;
 
   // support callback function as second arg
@@ -532,8 +559,16 @@ app.render = function render(name, options, callback) {
     opts = {};
   }
 
+  // merge app.locals
+  merge(renderOptions, this.locals);
+
+  // merge options._locals
+  if (opts._locals) {
+    merge(renderOptions, opts._locals);
+  }
+
   // merge options
-  var renderOptions = { ...this.locals, ...opts._locals, ...opts };
+  merge(renderOptions, opts);
 
   // set .cache unless explicitly provided
   if (renderOptions.cache == null) {
@@ -583,8 +618,8 @@ app.render = function render(name, options, callback) {
  * and HTTPS server you may do so with the "http"
  * and "https" modules as shown here:
  *
- *    var http = require('node:http')
- *      , https = require('node:https')
+ *    var http = require('http')
+ *      , https = require('https')
  *      , express = require('express')
  *      , app = express();
  *
@@ -596,14 +631,9 @@ app.render = function render(name, options, callback) {
  */
 
 app.listen = function listen() {
-  var server = http.createServer(this)
-  var args = Array.prototype.slice.call(arguments)
-  if (typeof args[args.length - 1] === 'function') {
-    var done = args[args.length - 1] = once(args[args.length - 1])
-    server.once('error', done)
-  }
-  return server.listen.apply(server, args)
-}
+  var server = http.createServer(this);
+  return server.listen.apply(server, arguments);
+};
 
 /**
  * Log error using console.error.