gina 0.1.6-alpha.16 → 0.1.6-alpha.160

package/framework/v0.1.6-alpha.160/core/server.isaac.js

@@ -0,0 +1,790 @@
+"use strict";
+/**
+ * Isaac Server Integration
+ *
+ */
+const fs                    = require('fs');
+const { execSync }          = require('child_process');
+const {EventEmitter}        = require('events');
+const Eio                   = require('engine.io');
+// const zlib                  = require('zlib'); // gzip / deflate
+
+const lib               = require('./../lib');
+const inherits          = lib.inherits;
+const merge             = lib.merge;
+const console           = lib.logger;
+const Collection        = lib.Collection;
+const cache             = new lib.Cache();
+
+
+const env               = process.env.NODE_ENV
+    , isDev             = (/^true$/i.test(process.env.NODE_ENV_IS_DEV)) ? true : false
+    , scope             = process.env.NODE_SCOPE
+    , isLocalScope      = (/^true$/i.test(process.env.NODE_SCOPE_IS_LOCAL)) ? true : false
+    , isProductionScope = (/^true$/i.test(process.env.NODE_SCOPE_IS_PRODUCTION)) ? true : false
+;
+
+var refreshCore = function() {
+
+    var corePath    = getPath('gina').core;
+    var libPath     = getPath('gina').lib;
+
+    var core        = new RegExp( corePath );
+    var excluded    = [
+        _(corePath + '/gna.js', true)
+    ];
+
+    for (let c in require.cache) {
+        if ( (core).test(c) && excluded.indexOf(c) < 0 ) {
+            require.cache[c].exports = require( _(c, true) )
+        }
+    }
+
+    // Update lib & helpers
+    delete require.cache[require.resolve(_(libPath +'/index.js', true))];
+    require.cache[_(libPath +'/index.js', true)] = require( _(libPath +'/index.js', true) );
+    require.cache[_(corePath + '/gna.js', true)].exports.lib = require.cache[_(libPath +'/index.js', true)];
+
+    // Update plugins
+    delete require.cache[require.resolve(_(corePath +'/plugins/index.js', true))];
+    require.cache[_(corePath +'/plugins/index.js', true)] = require( _(corePath +'/plugins/index.js', true) );
+    require.cache[_(corePath + '/gna.js', true)].exports.plugins = require.cache[_(corePath +'/plugins/index.js', true)];
+}
+
+// Express compatibility
+const slice = Array.prototype.slice;
+
+
+function ServerEngineClass(options) {
+
+    console.debug('[ ENGINE ] Isaac says hello !');
+
+    // TOTO - See if it would be interesting to add it to Helper::Path & to extend it to also readdirSync, returning the directory content
+    var readSync = function(filename) {
+        var fileObj = new _(filename, true);
+        if ( fileObj.isSymlinkSync() ) {
+            filename = fileObj.getSymlinkSourceSync()
+        }
+
+        return fs.readFileSync(filename).toString()
+    }
+
+    var preferedEncoding    = options.preferedCompressionEncodingOrder
+        , acceptEncodingArr = null
+        , acceptEncoding    = null
+    ;
+
+    var localAssets             = null
+        , cachedAssets          = null
+        , cachePathObj          = null
+        , localCachePathObj     = null
+    ;
+    try {
+
+        // Adding cache directory if not found
+        cachePathObj = new _(options.cachePath, true);
+        localCachePathObj = new _(options.cachePath +'/'+ options.bundle, true);
+        if ( !cachePathObj.existsSync() ) {
+            cachePathObj.mkdirSync();
+        }
+        // Empty cache for cahceless envs
+        if ( options.isCacheless && localCachePathObj.existsSync() ) {
+            localCachePathObj.rmSync();
+        }
+        // For frontend template routing if needed
+        // TODO - Used `options.routing` instead after having filtered `options.allRoutes` vs `options.formsRules` to use only external routes exposed by `"query"` validation
+        var _routing = JSON.clone(options.allRoutes);
+        // var _routing = JSON.clone(options.routing);
+        for (let rule in _routing) {
+            if ( typeof(_routing[rule]._comment) != 'undefined' ) {
+                delete _routing[rule]._comment;
+            }
+            if ( typeof(_routing[rule].middleware) != 'undefined' ) {
+                delete _routing[rule].middleware;
+            }
+
+            // reverseRouting in done on te frontend side
+
+        }// EO for (let rule in _routing)
+
+        // Checking if brotli is installed
+        var brotliBin = null;
+        try {
+            brotliBin = execSync( 'which brotli' ).toString().trim();
+        } catch (binErr) {
+            // Means that it is not installed.
+        }
+        // Checking if gzip is installed
+        var gZipBin = null;
+        try {
+            gZipBin = execSync( 'which gzip' ).toString().trim();
+        } catch (binErr) {
+            // Means that it is not installed.
+        }
+
+        // Caching routing
+        let targetDir   = _(options.cachePath +'/'+ options.bundle +'/config', true);
+        let targetDirObj = new _(targetDir, true);
+        if ( ! targetDirObj.existsSync() ) {
+            targetDirObj.mkdirSync();
+        }
+        let targetFile  = null
+            , fd        = null
+            , buffer    = null
+            , cmd       = null
+            , brFileObj = null
+            , gzFileObj = null
+        ;
+        if (_routing) {
+            targetFile  = 'routing.json';
+            // Storing to disk
+            console.debug(`Writing ${targetFile} to: ${targetDir}/${targetFile}`);
+            fd = fs.openSync(targetDir +'/'+ targetFile, 'w'); // Open file for writing
+            buffer = Buffer.from( JSON.stringify(_routing) );
+            fs.writeSync(fd, buffer, 0, buffer.length, 0); // Write the buffer
+            fs.closeSync(fd); // Close the file descriptor
+
+            // Adding brotli version
+            // To enblable this feature, you need to install brotli on the host
+            // [ Mac Os X ] brew install brotli
+            // [ Debian/Ubuntu ] sudo apt install brotli
+            try {
+                if (brotliBin) {
+                    brFileObj = new _(targetDir +'/'+ targetFile +'.br');
+                    // Removing existing
+                    if ( brFileObj.existsSync() ) {
+                        brFileObj.rmSync();
+                    }
+                    // Creating a new br version
+                    cmd = brotliBin +' --best '+ _(targetDir +'/'+ targetFile, true);
+                    console.debug( execSync( cmd ).toString() );
+                }
+            } catch (brError) {
+                console.error('[ SERVER ] '+ brError.stack);
+            }
+
+            // Adding GZip version
+            // To enblable this feature, you need to install gzip on the host
+            // [ Mac Os X ] brew install gzip
+            // [ Debian/Ubuntu ] sudo apt install gzip
+            try {
+                if (gZipBin) {
+                    gzFileObj = new _(targetDir +'/'+ targetFile +'.gz');
+                    // Removing existing
+                    if ( gzFileObj.existsSync() ) {
+                        gzFileObj.rmSync();
+                    }
+                    // Creating a new br version
+                    cmd = gZipBin +' -9 -k '+ _(targetDir +'/'+ targetFile, true);
+                    console.debug( execSync( cmd ).toString() );
+                }
+            } catch (gzError) {
+                console.error('[ SERVER ] '+ gzError.stack);
+            }
+        }
+
+
+        buffer = null;
+        fd = null;
+
+
+        // TODO - Make a br or a gz file asside here
+        localAssets = [
+            {
+                file    : 'public_suffix_list.dat',
+                path    : getPath('gina').lib +'/domain/dist',
+                mime    : 'text/plain; charset=utf8'
+            },
+            {
+                file    : 'routing.json',
+                path    : targetDir,
+                mime    : 'application/json; charset=utf8'
+            }
+        ];
+        for (let i=0, len=localAssets.length; i<len; i++) {
+            let fileName  =  _(localAssets[i].path +'/'+ localAssets[i].file, true);
+            localAssets[i].content = readSync(fileName, 'utf8');
+        }// EO for localAssets
+
+    } catch (assetsError) {
+        // TODO - Reuse the default or the project 404 page
+        // fileContent = 'Not found';
+        console.error('[ SERVER ] '+ assetsError.stack);
+    }
+
+
+    // openssl req -x509 -newkey rsa:2048 -nodes -sha256 -subj "/CN=localhost" -keyout localhost-privkey.pem -out localhost-cert.pem
+    var credentials = {};
+    if ( /https/.test(options.scheme) ) {
+        try {
+            credentials = {
+                key: readSync(options.credentials.privateKey),
+                cert: readSync(options.credentials.certificate)
+            };
+        } catch(err) {
+            console.emerg('You are trying to start a secured server (https) wihtout suficient credentials: check your `server settings`\n'+ err.stack);
+            process.exit(1)
+        }
+    }
+
+
+    var allowHTTP1 = true; // by default
+    if (typeof (options.allowHTTP1) != 'undefined' && options.allowHTTP1 != '' ) {
+        allowHTTP1 = options.allowHTTP1;
+    }
+    credentials.allowHTTP1 = allowHTTP1;
+
+
+    if (typeof (options.credentials.ca) != 'undefined' && options.credentials.ca != '' )
+        credentials.ca = options.credentials.ca;
+
+    if (typeof (options.credentials.pfx) != 'undefined' && options.credentials.pfx != '' )
+        credentials.pfx = readSync(options.credentials.pfx);
+
+    if (typeof (options.credentials.passphrase) != 'undefined' && options.credentials.passphrase != '' )
+        credentials.passphrase = options.credentials.passphrase;
+
+    var server = null, http = null, ioServer = null;
+
+
+    if ( /^http\/2/.test(options.protocol) ) {
+        var http2   = require('http2');
+        switch (options.scheme) {
+            case 'http':
+                server      = http2.createServer({ allowHTTP1: allowHTTP1 });
+                break;
+
+            case 'https':
+                server      = http2.createSecureServer(credentials);
+                break;
+
+            default:
+                server      = http2.createServer({ allowHTTP1: allowHTTP1 });
+                break;
+        }
+    } else {
+
+        switch (options.scheme) {
+            case 'http':
+                http        = require('http');
+                server      = http.createServer();
+                break;
+
+            case 'https':
+                var https   = require('https');
+                server      = https.createServer(credentials);
+                break;
+
+            default:
+                http        = require('http');
+                server      = http.createServer();
+                break;
+        }
+    }
+
+
+
+    const middleware = function(path, cb) {
+
+        // if (request.path === path) {
+        //     onPath.call(this, path, cb)
+        // }  else { // 404
+        //     stream.respond({
+        //         'content-type': 'text/html',
+        //         ':status': 404
+        //     });
+        //     stream.end('<h1>404</h1>');
+        // }
+    }
+
+
+    const onPath = function(path, cb, allowAll) {
+
+        var queryParams         = null
+            , i                 = null
+            , len               = null
+            , p                 = null
+            , arr               = null
+            , a                 = null
+            , isProxyHost       = null
+            , requestHost       = null
+            , isBinary          = null
+            , isCacheless       = options.isCacheless
+            , assetsCollection  = new Collection(localAssets)
+            , localAsset        = null
+            , cachedContents    = null
+            , cachedContentObj  = null
+            , cachedIndexes     = []
+            , cachedIndexe      = null
+        ;
+
+
+        // http2stream handle by the Router class & the SuperController class
+        // See `${core}/router.js` & `${core}/controller/controller.js`
+
+        server.on('request', (request, response) => {
+
+            request.originalUrl = request.url;
+
+            acceptEncodingArr = null;
+            if ( typeof(request.headers['accept-encoding']) != 'undefined' ) {
+                acceptEncodingArr   = request.headers['accept-encoding'].replace(/\s+/g, '').split(/\,/);
+            }
+            acceptEncoding      = null;
+            isBinary            = false;
+
+            // Proxy detection
+            isProxyHost = getContext('isProxyHost') || false;
+            requestHost = request.headers.host || request.headers[':authority'];
+            // console.debug('[PROXY_HOST][isProxyHost='+ isProxyHost +'] request.headers.host -> ' + request.headers.host + '  VS request.headers[":authority"] '+ request.headers[':authority'] +' | '+ request.url);
+            if (
+                !isProxyHost
+                && !/\:[0-9]+$/.test(requestHost)
+                ||
+                !isProxyHost
+                && request.headers['x-forwarded-host']
+            ) {
+                // Enable proxied mode
+                process.gina.PROXY_HOSTNAME = process.gina.PROXY_SCHEME +'://'+ requestHost;
+                process.gina.PROXY_HOST     = requestHost;
+                // For internal services communications - Eg.: Controller::query()
+                if (request.headers['x-forwarded-host']) {
+                    process.gina.PROXY_HOSTNAME = request.headers['x-forwarded-proto'] +'://'+ request.headers['x-forwarded-host'];
+                    process.gina.PROXY_HOST     = request.headers['x-forwarded-host'];
+                    // console.debug('[PROXY_HOST][X-FORWARDED-PROTO] override request.headers["x-forwarded-host"] -> ' + request.headers['x-forwarded-host']);
+                }
+                // Forcing context - also available for workers
+                setContext('isProxyHost', true);
+            }
+
+            // TODO - remove this after k8s test
+            // if (
+            //     // skip internal requests like healthcheck
+            //     !/^localhost:[0-9]+$/.test(requestHost)
+            //     && /^true$/.test(isProxyHost)
+            //     && /\:[0-9]+$/.test(requestHost)
+            //     && !hostnameRE.test(requestHost)
+            // ) {
+            //     // Restoring non-proxied mode
+            //     console.debug('[ SERVER ] proxy disabled: '+ process.gina.PROXY_SCHEME +'://'+ requestHost);
+            //     isProxyHost = false;
+            //     setContext('isProxyHost', isProxyHost);
+            // }
+
+            // healthcheck
+            // TODO - add a top level API : server.api.js (check, get ...)
+            // TODO - on 90% RAM usage, redirect to `come back later then restart bundle`
+            // TODO - check url against wroot : getContext() ?
+            if ( /^get$/i.test(request.method) && /\_gina\/health\/check$/i.test(request.url) ) {
+                // server.toApi(reques, response)
+                // console.debug('[ SERVER ][200] '+ request.url);
+                response.setHeader('cache-control', 'no-cache, no-store, must-revalidate');
+                response.setHeader('pragma', 'no-cache');
+                response.setHeader('expires', '0');
+                response.setHeader('content-type', 'application/json; charset=utf8');
+                response.setHeader('X-Powered-By', 'Gina/'+ GINA_VERSION);
+
+                return response.end('{"status":"ok","cache-is-enabled":'+ server._cacheIsEnabled +'}');
+            }
+
+
+            if (
+                /^get$/i.test(request.method) && /\_gina\/assets\/public_suffix_list.dat$/i.test(request.url)
+                ||
+                /^get$/i.test(request.method) && /\_gina\/assets\/routing\.json$/i.test(request.url)
+            ) {
+                // server.toApi(reques, response)
+                // console.debug('[ SERVER ][200] '+ request.url);
+                localAsset = assetsCollection.findOne({ file: request.url.split(/\//g).slice(-1).toString() });
+                response.setHeader('content-type', localAsset.mime);
+                response.setHeader('vary', 'Origin');
+                response.setHeader('cache-control', 'public, max-age=86400');
+                response.setHeader('x-content-type-options', 'nosniff');
+                response.setHeader('x-frame-options', 'DENY');
+                response.setHeader('x-xss-protection', '1; mode=block');
+                response.setHeader('X-Powered-By', 'Gina/'+ GINA_VERSION);
+
+                var filename  =  _(localAsset.path +'/'+ localAsset.file, true);
+                if (acceptEncodingArr) {
+                    for (let e=0, eLen=preferedEncoding.length; e<eLen; e++) {
+                        if ( acceptEncodingArr && acceptEncodingArr.indexOf(preferedEncoding[e]) > -1 ) {
+                            acceptEncoding = options.coreConfiguration.encoding[ preferedEncoding[e] ] ;
+                            break;
+                        }
+                    }
+                }
+                // Compressed content
+                if (
+                    !isCacheless
+                    && acceptEncoding
+                    && fs.existsSync(filename + acceptEncoding)
+                ) {
+                    isBinary = true;
+                    filename += acceptEncoding;
+                    // https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Encoding
+                    response.setHeader('content-encoding', acceptEncoding.replace(/^\./, ''));
+                    // override content length
+                    response.setHeader('content-length', fs.statSync(filename).size);
+                }
+
+                if (!isBinary) {
+                    console.info(request.method +' [200] '+ request.url);
+                    return response.end(localAsset.content);
+                }
+
+                return fs.createReadStream(filename)
+                    .on('end', function onResponse(){
+                        console.info(request.method +' [200] '+ request.url);
+                    })
+                    .pipe(response);
+            }
+
+
+            if (isDev) {
+                refreshCore()
+            }
+
+            if (!isCacheless || /^true$/i.test(server._cacheIsEnabled)) {
+                if ( /^GET$/i.test(request.method) ) {
+                    var cacheStatus = null;
+                    if ( /^true$/i.test(server._cacheIsEnabled) ) {
+                        cacheStatus = 'gina-cache';
+                    }
+
+                    // Importing cache handler
+                    cache.from(server._cached);
+                    var cacheKey        = null
+                        , hasCachedKey  = false
+                        , keyPrefixes   = ['data:', 'static:']
+                    ;
+                    for (let p=0, pLen=keyPrefixes.length; p<pLen; p++ ) {
+                        cacheKey = keyPrefixes[p] + request.url;
+                        if ( cache.has(cacheKey) ) {
+                            hasCachedKey = true;
+                            break;
+                        }
+                    }
+
+                    if ( hasCachedKey ) {
+                        // Getting cache from key
+                        cachedContentObj = cache.get(cacheKey);
+
+                        // Getting the headers
+                        cacheStatus += '; hit';
+                        if ( typeof(cachedContentObj.ttl) != 'undefined' && cachedContentObj.ttl > 0) {
+                            var createdAt = cachedContentObj.createdAt.getTime()+ (~~(cachedContentObj.ttl)*1000);
+                            var remainingSeconds = Math.floor( (createdAt - new Date().getTime()) /1000);
+
+                            cacheStatus += '; ttl='+remainingSeconds;
+                            createdAt = null;
+                            remainingSeconds = null;
+                        }
+
+                        if ( typeof(cachedContentObj.responseHeaders) != 'undefined' ) {
+                            for (let h in cachedContentObj.responseHeaders ) {
+                                response.setHeader(h, cachedContentObj.responseHeaders[h]);
+                            }
+                        }
+                        response.setHeader('Cache-Status', cacheStatus);
+                        if (
+                            typeof(cachedContentObj.fromMemory) != 'undefined'
+                        ) {
+                            console.info(request.method +' [200]['+ cacheStatus +'] '+ request.url);
+                            return response.end(cachedContentObj.content);
+                        }
+
+                        filename  =  _(cachedContentObj.filename, true);
+
+                        return fs.createReadStream(filename)
+                            .on('error', function onError(err) {
+                                console.error("[SERVER][CACHE][FILE ERROR] ", err.stack|err.message|err);
+                                return response.end(''+ err.stack|err.message|err);
+                            })
+                            .on('end', function onResponse(){
+                                console.info(request.method +' [200] '+ request.url);
+                            })
+                            .pipe(response);
+                    } // EO if ( cache.has(cacheKey) )
+                    if (cacheStatus) {
+                        cacheStatus += '; uri-miss';
+                        response.setHeader('Cache-Status', cacheStatus);
+                    }
+
+
+                    cacheKey        = null;
+                    hasCachedKey    = null;
+                    keyPrefixes     = null;
+                } // EO if ( /^GET$/i.test(request.method) )
+            } // EO if (!isCacheless)
+
+
+
+            if ( /engine.io/.test(request.url)) {
+                console.debug('[ SERVER ] engine.io request');
+            }
+
+            if (/^\*$/.test(path) || path == request.url) {
+                request.params  = {};
+                request.query   = {};
+
+                if ( /\?/.test(request.url) ) {
+
+                    queryParams = request.url.split(/\?/);
+
+                    len = queryParams.length;
+                    // fixing `?` > 1 occurence
+                    if (len > 2) {
+                        queryParams[1] = queryParams.slice(1).join('&');
+                        // cleanup
+                        queryParams.splice(2);
+                        len = queryParams.length;
+                    }
+                    request.params[0] = queryParams[0];
+
+                    if ( /\&/.test(queryParams[1]) ) {
+                        i = 1;
+                        for (; i < len; ++i) {
+
+                            arr = queryParams[i].split(/\&/);
+                            p = 0;
+                            for (; p < arr.length; ++p) {
+                                a = arr[p].split(/\=/);
+                                // false & true case
+                                if ( /^(false|true|on)$/i.test(a[1]) )
+                                    a[1] = ( /^(true|on)$/i.test(a[1]) ) ? true : false;
+                                else if (a[1] && a[1].indexOf('%') > -1)
+                                    a[1] = decodeURIComponent(a[1]);
+
+                                if (/^(\{|\[)/.test(a[1]) ) {
+                                    try {
+                                        a[1] = JSON.parse(a[1]);
+                                    } catch(notAJsonError) {
+                                        console.warn('[SERVER][INCOMING REQUEST]', 'Could not convert to JSON or Array this key/value to :' + a[0] + ': '+a[1] +'/nLeaving value as a string.');
+                                    }
+                                }
+                                request.query[ a[0] ] = a[1]
+                            }
+                        }
+                    } else {
+                        a = queryParams[1].split(/\=/);
+
+                        if (a.length > 1) {
+                            // false & true case
+                            if ( /^(false|true|on)$/i.test(a[1]) )
+                                a[1] = ( /^(true|on)$/i.test(a[1]) ) ? true : false;
+
+                            request.query[ a[0] ] = a[1]
+                        } else { // for redirection purposes or when passing `?encodedJsonObject`
+                            try {
+                                if ( a[0].indexOf('%') > -1 ) { // encoded URI Component
+                                    a[0] = decodeURIComponent(a[0])
+                                }
+
+                                request.query = a[0] ? JSON.parse(a[0]) : {};
+                            } catch(err) {
+                                console.error(err.stack)
+                            }
+                        }
+
+                    }
+                    request.url = request.url.replace(/\?.*/, '')
+                } else {
+                    request.params[0] = request.url
+                }
+
+                var referer     = null
+                    , authority = request.scheme + '://'+ request.authority
+                    , host      = null
+                ;
+                if ( typeof(request.headers.origin) != 'undefined' ) {
+                    referer = request.headers.origin;
+                } else if (request.headers.referer || request.authority) {
+                    referer = request.headers.referer || authority;
+                }
+                var a = null;
+                if (authority) {
+                    a = authority.match(/^[https://|http://][a-z0-9-_.:/]+/);
+                    if (a) {
+                        a[0].split(/\//g);
+                        a.splice(3);
+                        authority = a.join('/');
+                        host = authority;
+                    }
+                }
+
+                if ( referer && /^(https\:\/\/|http\:\/\/)/.test(referer) ) {
+                    if (referer != authority ) {
+                        a = referer.match(/^[https://|http://][a-z0-9-_.:/]+\//)[0].split(/\//g);
+                        a.splice(3);
+                        referer = a.join('/');
+                    }
+
+                    a = null;
+                }
+                request.origin = referer;
+                if (!host && referer) {
+                    host = referer;
+                } else if (!host && typeof(request.headers.host) != 'undefined' ) {
+                    host = request.headers.host;
+                }
+
+                var port = null;
+                try {
+                    port = host.match(/\:\d+/);
+                } catch (portError) {
+                    console.warn('[SERVER] Port not in string for host `'+ host +'`.\nSetting default port to 80.');
+                }
+                if (port) {
+                    host = host.replace(port[0], '');
+                    port = ~~(port[0].substring(1));
+                } else {
+                    port = 80;
+                }
+
+                if (host) {
+                    host = host.replace(/^(https\:\/\/|http\:\/\/)/, '');
+
+                    // https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Origin
+                    if ( /^http\/2/.test(options.protocol) ) {
+                        request.headers[':host']    = host;
+                        request.headers[':port']    = port;
+                    } else if ( typeof(request.headers.hostname) == 'undefined') {
+                        request.headers.host = host;
+                        request.headers.port = port;
+                    }
+
+                    request.port    = port;
+                    request.host    = host;
+
+                    port    = null;
+                    referer = null;
+                }
+
+
+                cb(request, response);
+            }
+        });
+
+    }
+
+
+    // All paths allowed
+    server.all = function(path, cb) {
+        onPath.call(this, path, cb, true)
+    }
+
+    // configuring express plugins|middlewares
+    server._expressMiddlewares = [];
+    /**
+     * <server>.use()
+     * Applies middleware for every single route
+     *
+     * @param {function} fn
+     */
+    server.use = function use(fn) {
+
+        var offset = 0;
+        //var path = '/';
+
+        // default path to '/'
+        // disambiguate app.use([fn])
+        if (typeof fn !== 'function') {
+          var arg = fn;
+
+          while (Array.isArray(arg) && arg.length !== 0) {
+            arg = arg[0];
+          }
+
+          // first arg is the path
+          if (typeof arg !== 'function') {
+            offset = 1;
+            path = fn;
+          }
+        }
+
+
+        var fns = merge(slice.call(arguments, offset));
+
+        if (fns.length === 0) {
+          throw new TypeError('server.use() requires a middleware function')
+        }
+
+        fns.forEach(function (fn) {
+            server._expressMiddlewares[server._expressMiddlewares.length] = fn;
+        });
+
+        return this;
+    }
+
+
+    server.on('error', (err) => {
+        console.error(err)
+    });
+
+
+    //------------------------------------
+    // Engine IO server
+    // https://socket.io/docs/v4/server-api/#socketsendargs
+    //------------------------------------
+    if (
+        typeof(options.ioServer) != 'undefined'
+        && typeof(options.ioServer.integrationMode) != 'undefined'
+        && /^attach$/.test(options.ioServer.integrationMode)
+    ) {
+        console.info('[IO SERVER ] `eio` found using `'+ options.ioServer.integrationMode +'` integration mode');
+        delete options.ioServer.integrationMode;
+        // test done in case we would like to switch to socket.io-server
+        ioServer = ( typeof(Eio.attach) != 'undefined' ) ? new Eio.attach(server, options.ioServer) : new Eio(server, options.ioServer);
+
+        server.eio = ioServer;
+
+        ioServer.on('connection', function (socket) {
+
+            socket.send(JSON.stringify({
+                id: this.id,//socket.id,
+                handshake: 'Welcomed to `'+ options.bundle +'` main socket !',
+                // how many ms before sending a new ping packet
+                pingTimeout: options.ioServer.pingTimeout || options.ioServer.timeout,
+                // how many ms without a pong packet to consider the connection closed
+                pingInterval: options.ioServer.pingInterval || options.ioServer.interval
+            }));
+
+            socket.on('message', function(payload){
+
+                try {
+                    console.debug('[IO SERVER ] receiving '+ payload);
+                    payload = JSON.parse(payload);
+                    // bind to session ID
+                    if ( typeof(payload.session) != 'undefined' ) {
+                        this.sessionId = payload.session.id;
+                    }
+                } catch(err) {
+                    console.error(err.stack||err.message|| err)
+                }
+            });
+
+            socket.on('close', function(){
+                console.debug('[IO SERVER ] closed socket #'+ this.id);
+            });
+        });
+
+        server.on('upgrade', function(req, socket, head){
+            console.debug('[IO SERVER ] upgrading socket #'+ this.id);
+            ioServer.handleUpgrade(req, socket, head);
+        });
+        // httpServer.on('request', function(req, res){
+        //     ioServer.handleRequest(req, res);
+        // });
+
+
+    }
+
+
+
+    return {
+        instance: server,
+        middleware: middleware
+    }
+};
+
+module.exports = ServerEngineClass;