slower 1.1.9 → 1.1.10

package/lib/router.js

@@ -1,6 +1,6 @@
 const http = require('http');
 const fs = require('fs');
-const { noop, slugify, isSparseEqual, last, renderDynamicHTML } = require('./utils');
+const { noop, slugify, isSparseEqual, last, renderDynamicHTML, setSocketLocals } = require('./utils');
 
 class Route {
     constructor (path, type, callback) {
@@ -289,6 +289,8 @@ class SlowerRouter {
 
         let server = http.createServer(function (req, res) {
             try {
+                // Sets local req.session object
+                setSocketLocals(req);
                 // Runs all middlewares
                 for (let i = 0; i < middle.length; i++) { middle[i](req, res); }
                 // Only respond to allowed methods with callbacks, else, use the default empty response.

package/lib/utils.js

@@ -69,6 +69,23 @@ const renderDynamicHTML = (html, patterns) => {
     return template;
 }
 
+const setSocketLocals = (socket) => {
+    socket.session = {};
+    socket.session.port = socket.socket.localPort;
+    socket.session.rport = socket.socket.remotePort;
+    socket.session.host = (
+        socket.socket.localAddress.startsWith('::') ? 
+        socket.socket.localAddress.substring(
+            socket.socketlocalAddress.indexOf(':',2)+1
+        ) : socket.socket.localAddress);
+        socket.session.rhost = (
+        socket.socket.remoteAddress.startsWith('::') ? 
+        socket.socket.remoteAddress.substring(
+            socket.socket.remoteAddress.indexOf(':',2)+1
+        ) : socket.socket.remoteAddress);
+    return socket;
+}
+
 const toBool = [() => true, () => false];
 
-module.exports = { noop, slugify, isSparseEqual, toBool, last, renderDynamicHTML };
+module.exports = { noop, slugify, isSparseEqual, toBool, last, renderDynamicHTML, setSocketLocals };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slower",
-  "version": "1.1.9",
+  "version": "1.1.10",
   "description": "",
   "main": "index.js",
   "directories": {

package/readme.md

@@ -46,4 +46,21 @@ app.start(port, null, () => {
     console.log(`Running on localhost:${port}`);
     console.log(app);
 });
-```
+```
+### API modifications on 'net.Socket' instances:
+ - The API modifies every ```net.Socket``` instance BEFORE it is passed 
+to ```app.connectionListener```. This means that all events receiving 
+a socket will receive the modified socket instead.
+ - The modifications adds the following properties to the socket instance:
+```
+ <socket>.session: Object           => A container for persistent data appended to sockets
+ <socket>.session.port: Number      => The local port number
+ <socket>.session.rport: Number     => The remote port number
+ <socket>.session.host: String      => The local host interface address
+ <socket>.session.rhost: String     => The remote host interface address
+```
+- It is possible to use the ```socket.session``` object to append data that will persist 
+during the lifetime of a single connection. Useful for keeping short-life local variables.
+
+- In HTTP ```http.IncomingMessage``` instances, the 'socket' instance is found over 'request'.
+So, considering the common callback of ```(req, res)```, the session container will be ```req.session```