slower 1.1.26 → 2.0.0

package/lib/router.js

@@ -1,476 +0,0 @@
-const http = require('http');
-const https = require('https');
-const fs = require('fs');
-const { clone, noop, slugify, isSparseEqual, last, renderDynamicHTML, setSocketLocals, setSocketSecurityHeaders, setResponseAssessors, isPromise, UUID } = require('./utils');
-const mimetable = require('./mimetable.json');
-
-class Route {
-    constructor (path, type, callback) {
-        this.path = (path.startsWith('/') ? path : '/' + path);
-        this.type = SlowerRouter.http_methods.includes(slugify(type).toUpperCase()) ? slugify(type).toUpperCase() : null;
-        this.callback = (typeof callback == 'function' ? callback : noop);
-    }
-}
-
-class SlowerRouter {
-    static http_methods = [
-        'GET',       'POST',        'PUT',
-        'HEAD',      'DELETE',      'OPTIONS',
-        'TRACE',     'COPY',        'LOCK',
-        'MKCOL',     'MOVE',        'PURGE',
-        'PROPFIND',  'PROPPATCH',   'UNLOCK',
-        'REPORT',    'MKACTIVITY',  'CHECKOUT',
-        'MERGE',     'M-SEARCH',    'NOTIFY',
-        'SUBSCRIBE', 'UNSUBSCRIBE', 'PATCH',
-        'SEARCH',    'CONNECT'
-    ];
-
-    static mime_table = mimetable; 
-
-    constructor () {
-        this.strictHeaders = false;
-        this.routes = [];
-        this.middleware = [noop];
-        this.fallback = noop;
-        this.allowedMethods = clone(SlowerRouter.http_methods);
-        this.blockedMethodCallback = noop;
-        this.tls = { use: false, key: null, cert: null };
-        this.server = null;
-        this.connectionpool = {};
-    }
-
-    enableStrictHeaders () {
-        // This activates the responses with many security-related response headers.
-        //  It is not enabled by default, as some header are very restrictive
-        this.strictHeaders = true;
-        return this;
-    }
-
-    disableStrictHeaders () {
-        // This deactivates the responses with many security-related response headers.
-        //  It is not enabled by default, as some headers are very restrictive
-        this.strictHeaders = false;
-        return this;
-    }
-
-    setSecureContext (key = null, cert = null) {
-        // Activates TLS and HTTPS using a certificate and a key
-        if (!key || !cert || !Buffer.isBuffer(key) || !Buffer.isBuffer(cert)) {
-            throw new Error ("INVALID SECURE CONTEXT INFORMATION PROVIDED - CHECK KEY AND CERTIFICATE");
-        }
-        this.tls.use = true;
-        this.tls.key = key;
-        this.tls.cert = cert;
-        return this;
-    }
-
-    /**
-     * Defines a route for a determined request method 
-     * @category Router
-     * @param {String} path The route that will be defined
-     * @param {String} type The method to respond to
-     * @param {Function} callback Callback to use when the chosen route is accessed
-     * @returns {Object} An Route object
-     * @example <caption> Defining a simple GET route:</caption>
-     * setRoute('/', 'GET', (req, res) => {
-     *     console.log(res.url);
-     *     res.end('received');
-     * });
-     * // => <Route> { path:..., type:..., callback:... }
-    */
-    setRoute = function (path = '/', type = 'GET', callback) {
-        let stat = new Route(path, type, callback);
-        this.routes.push(stat);
-        return this;
-    }
-
-    /**
-     * Defines a middleware for all requests 
-     * @category Middleware 
-     * @param {Function} callback Callback to use when the requests are made
-     * @returns {Array} The used middlewares list
-    */
-    setMiddleware = function (callback) {
-        this.middleware.push((typeof callback == 'function' ? callback : noop));
-        return this;
-    }
-    
-    /**
-     * Defines a route for a determined request method 
-     * @category Router
-     * @param {String} path The route that will be defined
-     * @param {String} file The file path that will be used to respond to the route
-     * @param {String} mime The file's mime type
-     * @param {Object} replacementData The replacement data map for the dynamic HTML rendering
-     * @returns {Object} An Route object already configured
-    */
-    /**
-    * Dynamic rendering example:
-        * It's a template engine, to render HTML containing template spaces.
-        * The charset for replacement is <{content}>
-        * @since 1.2.5
-        * 
-        * @param  {String} html The HTML code
-        * @param  {Object} patterns The patterns to replace in the HTML code
-        * @return {String} The HTML with the templates replaces
-        * 
-        * @example <caption> Rendering: </caption>
-        * var template = 'Hello, my name is <{name}>. I\\'m <{age}> years old.';
-        * console.log(TemplateEngine(template, {
-        *   name: "Krasimir",
-        *   age: 29
-        * }));
-    */
-    setDynamic = function (path, file = '', mime = '', replacementData = null) {
-        let encoding = (mime === SlowerRouter.mime_table['default'] ? undefined : 'utf-8');
-        if (file.includes('{%}')) { file = file.replace(/\{\%\}/gim, path.replace(/\//gim,'')); }
-        let stat = new Route(path, 'GET', (req, res) => {
-            let data, targetFile, extension, targetMime, targetEncoding;
-            if (fs.existsSync(file) && fs.lstatSync(file).isDirectory()) {
-                targetFile = file.replace(/\//gim, '\\');
-                targetFile = ((targetFile.endsWith('\\')) ? targetFile : targetFile+'\\') + req.url.replace('/', '');
-            } else {
-                targetFile = ((file == '' || !file) ? req.url : file);
-            }
-            extension = last(targetFile.split('.'));
-            targetMime = mime || (SlowerRouter.mime_table[extension]?.[0] || SlowerRouter.mime_table.default[0]);
-            targetEncoding = encoding || (SlowerRouter.mime_table[extension]?.[1] || SlowerRouter.mime_table.default[1]);
-            try {
-                data = fs.readFileSync(targetFile, targetEncoding);
-            } catch (err) {
-                data = ''; 
-            }
-            try {
-                if (replacementData) data = renderDynamicHTML(data, replacementData);
-            } catch (err) {}
-            res.writeHead(200, { 'Content-Type': targetMime }); 
-            res.write(data);
-            res.end();
-        });
-        this.routes.push(stat);
-        return this;
-    }
-    
-    // SERVES FILES FOR SPECIFIC PATHS. WILDCARS ALLOWED. BE CAREFUL - PATH TRAVERSAL MAY BE POSSIBLE
-    // Use app.setStatic('/*', __dirname+'/') for serving all local files. 
-    // or use app.setStatic('/*', __dirname+'/public/') for serving files in a specific folder (public). 
-    // This is a one-liner for the setRoute function, when the route responds with a simple page or document
-    /**
-     * Defines a route for a determined request method 
-     * @category Router
-     * @param {String} path The route that will be defined
-     * @param {String} file The file path that will be used to respond to the route
-     * @param {String} mime The file's mime type
-     * @returns {Object} An Route object already configured
-     * @example <caption> Defining a simple GET route:</caption>
-     * setStatic('/login', __dirname+'/public/static/views/{%}.html', 'text/html');
-    */
-    setStatic = function (path, file = '', mime = '') {
-        let encoding = (mime === SlowerRouter.mime_table['default'] ? undefined : 'utf-8');
-        if (file.includes('{%}')) { file = file.replace(/\{\%\}/gim, path.replace(/\//gim,'')); }
-        let stat = new Route(path, 'GET', (req, res) => { 
-            let data, targetFile, extension, targetMime, targetEncoding;
-            if (fs.existsSync(file) && fs.lstatSync(file).isDirectory()) {
-                targetFile = file.replace(/\//gim, '\\');
-                targetFile = ((targetFile.endsWith('\\')) ? targetFile : targetFile+'\\') + req.url.replace('/', '');
-            } else {
-                targetFile = ((file == '' || !file) ? req.url : file);
-            }
-            extension  = last(targetFile.split('.'));
-            targetMime = mime || (SlowerRouter.mime_table[extension]?.[0] || SlowerRouter.mime_table.default[0]);
-            targetEncoding = encoding || (SlowerRouter.mime_table[extension]?.[1] || SlowerRouter.mime_table.default[1]);
-            try { 
-                data = fs.readFileSync(targetFile, targetEncoding); 
-            } catch (err) { 
-                data = ''; 
-            }
-            res.writeHead(200, { 'Content-Type': targetMime }); 
-            res.write(data);
-            res.end(); 
-        });
-        this.routes.push(stat);
-        return this;
-    }
-
-    /**
-     * Defines a default response for non-defined routes (custom treated 404 error) 
-     * @category Router
-     * @param {String} callback The function to execute for unhandled routes
-     * @returns {undefined}
-    */
-    setFallback = function (callback) { this.fallback = callback; return this; }
-
-    // SERVES FILES FOR SPECIFIC PATHS. WILDCARS ALLOWED. BE CAREFUL - PATH TRAVERSAL MAY BE POSSIBLE
-    // Use app.setStatic('/*', __dirname+'/') for serving all local files. 
-    // or use app.setStatic('/*', __dirname+'/public/') for serving files in a specific folder (public). 
-    // This is a one-liner for the setRoute function, when the route responds with a simple page or document
-    /**
-     * Defines a route for a determined request method 
-     * @category Router
-     * @param {String} path The route that will be defined
-     * @param {String} file The file path that will be used to respond to the route
-     * @param {String} mime The file's mime type
-     * @param {Object} replacementData The replacement data map for the dynamic HTML rendering
-     * @returns {Object} An Route object already configured
-     * @example <caption> Defining a simple GET route:</caption>
-     * setStatic('/login', __dirname+'/public/static/views/login.html', 'text/html', 'utf8');
-    */
-    /**
-    * Dynamic rendering example:
-        * It's a template engine, to render HTML containing template spaces.
-        * The charset for replacement is <{content}>
-        * @since 1.2.5
-        * 
-        * @param  {String} html The HTML code
-        * @param  {Object} patterns The patterns to replace in the HTML code
-        * @return {String} The HTML with the templates replaces
-        * 
-        * @example <caption> Rendering: </caption>
-        * var template = 'Hello, my name is <{name}>. I\\'m <{age}> years old.';
-        * console.log(TemplateEngine(template, {
-        *   name: "Krasimir",
-        *   age: 29
-        * }));
-    */
-    setFallbackFile = function (file = '', mime = '', replacementData = null) {
-        this.fallback = function fb (req,res) {
-            let encoding = (mime === SlowerRouter.mime_table['default'] ? undefined : 'utf-8');
-            let data, targetFile, extension, targetMime, targetEncoding;
-            if (fs.existsSync(file) && fs.lstatSync(file).isDirectory()) {
-                targetFile = file.replace(/\//gim, '\\');
-                targetFile = ((targetFile.endsWith('\\')) ? targetFile : targetFile+'\\') + req.url.replace('/', '');
-            } else {
-                targetFile = ((file == '' || !file) ? req.url : file);
-            }
-            extension = last(targetFile.split('.'));
-            targetMime = mime || (SlowerRouter.mime_table[extension]?.[0] || SlowerRouter.mime_table.default[0]);
-            targetEncoding = encoding || (SlowerRouter.mime_table[extension]?.[1] || SlowerRouter.mime_table.default[1]);
-            try {
-                data = fs.readFileSync(targetFile, targetEncoding);
-            } catch (err) {
-                data = ''; 
-            }
-            try {
-                if (replacementData) data = renderDynamicHTML(data, replacementData);
-            } catch (err) {}
-            res.writeHead(200, { 'Content-Type': targetMime }); 
-            res.write(data);
-            res.end();
-        }
-        return this;
-    }
-
-    // Sets the methods that the application will respond to. The rest is simply discarded with empty responses.
-    // To configure a deeper level of error handling, or to serve customized 'METHOD_NOT_ALLOWED' errors,
-    // use 'setRoute' with params ('/*', {{method_name}}, (req,res) => { and serve the error file here });
-    // INFO: Middlewares are still triggered when a blocked method request comes.
-    /**
-     * Defines a route for a determined request method 
-     * @category Router
-     * @param {Array} methods The methods that are allowed by the application. Methods that do not conform with standards are ignored.
-     * @returns {Object} The AllowedMethods Array object.
-     * @example <caption> Allowing only GET and POST:</caption>
-     * app.setAllowedMethods(['GET', 'POST']);
-    */
-    setAllowedMethods = function (methods = []) {
-        this.allowedMethods = [];
-        // If not specified, all methods are allowed
-        if (methods.length == 0 || methods == '*') {
-            return this.allowedMethods = JSON.parse(JSON.stringify(SlowerRouter.http_methods));
-        }
-        for (let i = 0; i < methods.length; i++) {
-            if (!SlowerRouter.http_methods.includes(methods[i])) continue;
-            this.allowedMethods.push(methods[i]);
-        }
-        // Default callback for blocked methods respond with code 200 and an empty response
-        this.blockedMethodCallback = function (req,res) {
-            res.writeHead(405); // sends the meme error 418 'i am a teapot'
-            res.end();
-        };
-        return this;
-    }
-
-/*
-    Route Objects looks like:
-
-    { 
-        type: "route",
-        path: "/",
-        method: "GET",
-        handle: someFunction
-    }
-
-    {
-        type: "middleware",
-        handle: someFunction
-    }
-
-    {
-        type: "fallback",
-        handle: someFunction
-    }
-
-    {
-        type: "static",
-        path: "/style.css",
-        file: "./www/assets/style.css"
-    }
-
-    {
-        type: "dynamic",
-        path: "/client.html",
-        file: "./www/templates/client.html",
-        data: {
-            "CLIENTID": someRenderingFunction
-        }
-    }
-
-    {
-        type: "fallbackfile",
-        file: "./www/pages/404.html"
-        data: {
-            "CUSTOM_ERROR_MESSAGE": () => { return err.message },
-            "CUSTOM_ERROR_CODE": someErrorCodeFetchingFunction
-        }
-    }
-
-*/
-    // Converts a series of objectRoutes into actual internal routes
-    parse = function (routeObjectList) {
-        for (let entry of routeObjectList) {
-            const { type, path, method, file, data, handle } = entry;
-            switch (type) {
-                case 'route':           this.setRoute(path, method, handle);            break;
-                case 'middleware':      this.setMiddleware(handle);                     break;
-                case 'fallback':        this.setFallback(handle);                       break;
-                case 'static':          this.setStatic(path, file, undefined);          break;
-                case 'dynamic':         this.setDynamic(path, file, undefined, data);   break;
-                case 'fallbackfile':    this.setFallbackFile(file, undefined, data);    break;
-            }
-        }
-        return this;
-    }
-
-    // Starts the server - listening at <host>:<port>
-    /**
-     * @category Router
-     * @param {Number} port The port number the server will listen to.
-     * @param {String} host The host's network interface address the server will listen into (use a falsy value or '0.0.0.0' for listening on all).
-     * @returns {Promise<http.Server>} The server instance 
-    */
-    start = async function (port = 8080, host = undefined) {
-        let routes = this.routes;
-        let middle = this.middleware;
-        let fallback = this.fallback;
-        let allowedMethods = this.allowedMethods;
-        let blockedMethodCallback = this.blockedMethodCallback;
-        
-        if (this.tls.use && this.tls.cert && this.tls.key) {
-            this.server = https.createServer({ key:this.tls.key, cert: this.tls.cert }, mainServerHandler);
-
-        } else {
-            this.server = http.createServer({}, mainServerHandler);
-        }
-
-        this.server.on('connection', (socket) => {
-            const id = UUID();
-            this.connectionpool[id] = socket;
-            socket.on('close', () => delete this.connectionpool[id]);
-            socket.on('error', () => delete this.connectionpool[id]);
-            socket.on('timeout', () => { this.connectionpool[id].destroy(); delete this.connectionpool[id]; });
-        });
-
-        async function mainServerHandler (req, res) {
-            try {
-                // Sets local req.session object
-                setSocketLocals(req);
-                setResponseAssessors(res);
-                // Sets security headers in req.headers
-                // This is set before custom callbacks are applies
-                // so it is possible to override all of the headers
-                if (!!this.strictHeaders) setSocketSecurityHeaders(req); 
-                // Runs all middlewares
-                for (let i = 0; i < middle.length; i++) { 
-                    const rr = middle[i](req, res); 
-                    if (isPromise(rr)) await rr;
-                    if (res.writableEnded) return; // if res.end() is caller early in a middleware
-                }
-                // Only respond to allowed methods with callbacks, else, use the default empty response.
-                if (allowedMethods.includes(req.method)) {
-                    for (let i = 0; i < routes.length; i++) {
-                        let route = routes[i];
-                        if (
-                            route.type === req.method && 
-                            (
-                                route.path === req.url || 
-                                isSparseEqual(route.path, req.url)
-                            )
-                        ) {
-                            i = routes.length;
-                            const rr = route.callback(req, res);
-                            if (isPromise(rr)) await rr;
-                            // if (res.writableEnded) return; // if res.end() was called
-                            // else res.end(); // if res.end() was not called
-                            return;
-                        }
-                    }
-                    const rr = fallback(req,res);
-                    if (isPromise(rr)) await rr;
-                    if (!res.writableEnded) res.end(); 
-                } else {
-                    blockedMethodCallback(req, res);
-                    if (!res.writableEnded) res.end();
-                }
-            } catch(err) {
-                console.log(err);
-            }
-        }
-
-        this.port = port;
-        this.host = host;
-        if (!host) host = undefined; // Turn falsy values into undefined, for default behaviour
-        return new Promise((resolve, reject) => this.server.listen(port, host, () => resolve(this)));
-    }
-    
-    /**
-     * 
-     * @param {Object} options 
-     * @returns 
-     * Options include:
-     * forceDisconnection: boolean (default: false) - If enabled, force sockets to disconnect after a 2 seconds timeout.
-     * instantClose: boolean (default: false) - Only relevant if 'forceDisconnection' is enabled. If enabled, force sockets to disconnect immediately.
-     * silent: boolean (default: true) - If set to false, show the disconnection status messages.
-     */
-    close = async function ({ forceDisconnection = false, instantClose = false, silent = true } = {forceDisconnection: false, instantClose: false, silent: true}) {
-        return new Promise (async (resolve, reject) => {
-            this.server.on('close', () => resolve());
-            this.server.on('error', (err) => reject(err));
-
-            // After this, no more sockets can connect, but the already connected ones, remain
-            this.server.close();
-            if (!silent) console.log('<> Shutting down server...');
-
-            if (forceDisconnection) {
-                // wait 1 second before continuing
-                if (!instantClose) await new Promise ((resolve1, reject1) => setTimeout(resolve1, 1000));
-
-                // If there are sockets still connected (waiting for timeout), 
-                // wait until all disconnected or force all to disconnect after 2 seconds
-                if (!silent) {
-                    const activesockets = await new Promise((resolve2, reject2) => this.server.getConnections((err,count) => resolve2(count)));
-                    console.log(`<> Awaiting disconnection of active sockets [${activesockets}]`);
-                }
-
-                // wait 1 second and destroy the ones still connected
-                if (!instantClose) await new Promise ((resolve1, reject1) => setTimeout(resolve1, 1000));
-                for (let sock in this.connectionpool) {
-                    this.connectionpool[sock].destroy();
-                }
-            }
-        });
-    }
-}
-
-const Slower = function () { return new SlowerRouter(); }
-
-module.exports = Slower;

package/lib/utils.js

@@ -1,172 +0,0 @@
-const noop = function () {};
-
-const last = (array) => { return array[array.length-1]; }
-
-const slugify = (string, replacement = '-', replaceSpaces = true) => {
-    return (string
-        .replace(/<(?:.|\n)*?>/gm, '')
-        .replace(/[!\"#$%&'\(\)\*\+,\/:;<=>\?\@\[\\\]\^`\{\|\}~]/g, '')
-        .replace((replaceSpaces ? /(\s|\.)/g : /(\.)/g), replacement)
-        .replace(/—/g, replacement)
-        .replace(/-{2,}/g, replacement));
-}
-
-/**
- * Compares two strings in 'sparse' mode. Using the wildcards '{*}' and '{?}' to match strings. 
- * Use '{*}' for any number of (any) characters, and {?}' for one (any) character.
- * 
- * @since 1.2.7 
- * 
- * @param  {String} str1 The first string to compare
- * @param  {String} str2 The second string to compare
- * @return {Boolean} If the strings are sparsely equal or not
- * @example <caption> Comparing simple strings: </caption>
- * isSparseEqual("hello", "hello")
- * // => true
- * isSparseEqual("hello", "wello")
- * // => false
- * @example <caption> Comparing complex strings: </caption>
- * isSparseEqual("{?}ello", "hello")
- * // => true
- * isSparseEqual("h*", "hello")
- * // => true
- * isSparseEqual("h{*}e", "hello")
- * // => false
- * isSparseEqual("h{*}e", "helle")
- * // => true
-*/
-const isSparseEqual = (str1 = '', str2 = '') => {
-    const string1 = str1.replace(/{\?}/g, '.').replace(/{\*}/g, '.*');
-    const string2 = str2.replace(/{\?}/g, '.').replace(/{\*}/g, '.*');
-    const regex = new RegExp(`^${string1}$`);
-    return regex.test(string2);
-}
-
-/**
- * It's a template engine, to render HTML containing template spaces.
- * The charset for replacement is {{content}}
- * @since 1.2.5
- * 
- * @param  {String} html The HTML code
- * @param  {Object} patterns The patterns to replace in the HTML code
- * @return {String} The HTML with the templates replaces
- * 
- * @example <caption> Rendering: </caption>
- * var template = 'Hello, my name is {{name}}. I\\'m {{age}} years old.';
- * console.log(TemplateEngine(template, {
- *   name: "Krasimir",
- *   age: 29
- * }));
-*/
-const renderDynamicHTML = (html, patterns) => {
-    let template = html;
-    for (let item in patterns) {
-        template = template.replace(
-            new RegExp('{{'+item+'}}', 'gim'), 
-            patterns[item]
-        );
-    }
-    return template;
-}
-
-const setSocketLocals = (reqSocket) => {
-    reqSocket.session = {};
-    reqSocket.session.port = reqSocket.socket.localPort;
-    reqSocket.session.rport = reqSocket.socket.remotePort;
-    reqSocket.session.host = (
-        reqSocket.socket.localAddress.startsWith('::') ? 
-        reqSocket.socket.localAddress.substring(
-            reqSocket.socket.localAddress.indexOf(':',2)+1
-        ) : reqSocket.socket.localAddress);
-        reqSocket.session.rhost = (
-        reqSocket.socket.remoteAddress.startsWith('::') ? 
-        reqSocket.socket.remoteAddress.substring(
-            reqSocket.socket.remoteAddress.indexOf(':',2)+1
-        ) : reqSocket.socket.remoteAddress);
-    return reqSocket;
-}
-
-const setResponseAssessors = (resSocket) => {
-    resSocket.sendText = (data, code = 200) => {
-        resSocket.writeHead(code, { 'Content-Type': 'text/plain' }); 
-        resSocket.write(data);
-        resSocket.end();
-    };
-    resSocket.sendJSON = (data, code = 200) => {
-        resSocket.writeHead(code, { 'Content-Type': 'application/json' }); 
-        resSocket.write(typeof data === 'string' ? data : JSON.stringify(data));
-        resSocket.end();
-    };
-    resSocket.sendHTML = (data, code = 200) => {
-        resSocket.writeHead(code, { 'Content-Type': 'text/html' }); 
-        resSocket.write(data);
-        resSocket.end();
-    };
-}
-
-const setSocketSecurityHeaders = (req) => {
-    // This should be set in a regular website:
-    // Forces the use of HTTPS for a long time, including subDomains - and prevent MitM attacks
-    // Does not work in servers that don't allow HTTPS (like this one)
-    // req.setHeader('Strict-Transport-Security', ['max-age=31536000', 'includeSubDomains']); // Only works on HTTPS
-
-    // This blocks requests with MIME type different from style/css and */script
-    // TODO test this - probably gonna break the server, as MIMEs are not overriden here
-    // req.setHeader('X-Content-Type-Options', 'nosniff'); 
-
-    // This deines the main security policy - Usually, when using a website, 
-    // this should be highly customized, but, for simple sites, it can be leaved like that:
-    req.setHeader('Content-Security-Policy', [
-        'default-src=none',
-        'script-src=self',
-        'connect-src=self',
-        'img-src=self',
-        'style-src=self',
-        'frame-ancestors=none',
-        'form-action=self',
-        // 'upgrade-insecure-requests' // Only works on HTTPS
-    ]);
-    // Isolates the browsing context exclusively to same-origin documents. 
-    // Cross-origin documents are not loaded in the same browsing context.
-    req.setHeader('Cross-Origin-Opener-Policy', 'same-origin');
-    // The HTTP Cross-Origin-Resource-Policy response header conveys a desire 
-    // that the browser blocks no-cors cross-origin/cross-site requests to the given resource.
-    req.setHeader('Cross-Origin-Resource-Policy', 'same-site');
-    // A new HTTP response header that instructs the browser 
-    // to prevent synchronous scripting access between same-site cross-origin pages.
-    req.setHeader('Origin-Agent-Cluster', '?1');
-    // Blocks information about the website when sending 
-    // local requests or redirections to other sites
-    req.setHeader('Referrer-Policy', 'no-referrer');
-    // Enabling this makes all URLs in a page (even the cross domain ones)
-    // to be prefetched - This is dangerouns in terms of DNS queries
-    req.setHeader('X-DNS-Prefetch-Control', 'off');
-    // A legacy header, just for IE, and is highly dangerous
-    // Not setting this as disabled can cause malicious 
-    // HTML+JS code to be loaded in the wrong context
-    req.setHeader('X-Download-Options', 'noopen');
-    // Blocks attempts to display the website as an IFrame
-    // If another website tries to display this website as a frame,
-    // this header will block it
-    req.setHeader('X-Frame-Options', 'DENY');
-    // Set the unnecessary XSS-Protection legacy header to disabled
-    // This header increases the number of vulnerabilities, and is used only in IE
-    req.setHeader('X-XSS-Protection', 0);
-    // Remove X-Powered-By - This header allows attackers to 
-    // gather information about the application engine
-    if (req.hasHeader('X-Powered-By')) req.removeHeader('X-Powered-By');
-}
-
-const toBool = [() => true, () => false];
-
-const clone = (object) => JSON.parse(JSON.stringify(object));
-
-const isPromise = obj => {
-    return obj !== null &&
-    (typeof obj === 'object' || typeof obj === 'function') &&
-    typeof obj.then === 'function';
-}
-
-const UUID = () => '################################'.replace(new RegExp(`[#]`, 'gim'), () => Math.random().toString(16)[6]);
-
-module.exports = { clone, noop, slugify, isSparseEqual, toBool, last, renderDynamicHTML, setSocketLocals, setSocketSecurityHeaders, setResponseAssessors, isPromise, UUID };