views: ' + sess.views + '
expires in: ' + (sess.cookie.maxAge / 1000) + 's
', function (err) {\n\t\t\t\tif (err) console.error(err);\n\t\t\t\tresponse.end();\n\t\t\t});\n\t\t} else {\n\t\tsess.views = 1\n\t\t\tresponse.end('welcome to the session demo. refresh!')\n\t\t}\n\t}\n}\n```\n\n### SessionDyn `request.sessionDyn`\n\n**sessionDyn** is much faster then other sessions, but it is stores object references in memory,\nit is very optimized, and practically, doesn't store additional metadata.\n\n * `request.sessionDyn.ip()` - returns current user ip\n * `request.sessionDyn.host()` - returns `request.headers.host`\n * `request.sessionDyn.origin()` - returns `request.headers.origin`;\n * `request.sessionDyn.hashSession( sessionId )` - returns hashed `sessionId`\n * `request.sessionDyn.genSessionId()` - returns a new valid sessionId\n * `request.sessionDyn.sessionId()` - returns current sessionId\n * `request.sessionDyn.setExpire( secconds, sessionId )` - set session expire timeout, if `sessionId` is undefined it will update current session\n * `request.sessionDyn.getExpire( sessionId )` - get session expire timestamp, if `sessionId` is undefined it will work with current session\n * `request.sessionDyn.getCreated( sessionId )` - get creation `timestamp` for `sessionDyn` with id equal to `sessionId`\n * `request.sessionDyn.sessionExists( sessionId )`\t\t: function( sessionId ) - retruns true if exists a `sessionDyn` with iq equal with `sessionId`\n * `request.sessionDyn.getVars( sessionId )` - will return variables from a `sessionDyn` if it exists, if `sessionId` is `undefined` will return variables from current `sessionDyn` if sessionExists else retruns `false`\n\n### Request methods\n\n * `request.headers` - object that contains headers `{ \"header name\" : \"header value\", .... }`\n * `request.urlObject` - object that resulted on parsing current url\n```javascript\n var url = \"https://www.example.com/path/to-an-url?get=references#hash-link\";\n console.log(url.parseURL(true));\n```\n\n**Result:**\n```javascript\n {\n \"original\" : \"https://www.example.com/path/to-an-url?get=references#hash-link\",\n \"origin\" : \"https://www.example.com\",\"domain\":\"www.example.com\",\n \"domain_short\" : \"example.com\",\n \"pathname\" : \"/path/to-an-url\",\n \"reqQuery\" : \"get=references\",\n \"protocol\" : \"https\",\n \"protocoll\" : \"https://\",\n \"url\" : \"www.example.com/path/to-an-url?get=references#hash-link\",\n \"url_p\" : \"https://www.example.com/path/to-an-url?get=references#hash-link\",\n \"isIp\" : \"www.example.com\",\n \"get_vars\" : {\n \"get\" : \"references\"\n }\n }\n```\n\n * `request.controller` - current controller name\n * `request.controllerAction` - current action name\n * `request.params` - current parameters array\n * `request.postData` - `Buffer Object` where was stored original POST data\n * `request.postVars()` - returns `POST` vars stored in a object ( available as `request.body` )\n\n```javascript\n\t// for PUT method or other\n\tapp.put(function (request, response, next) {\n\t\trequest.postDataColect(next);\n\t});\n\n\tapp.put('/chat',function (request, response) {\n\t\tresponse.send(request.body);\n\t});\n```\n\n * `request.fileVars()` - returns `FILE` vars stored in a object\n * `request.sessionDyn` - returns `sessionDyn Object`\n * `request.session` - returns `session Object`\n * `request.redirect( url, status )` - redirects to a specified url with a specified status ( default `status = 302` )\n * `request.postDataState` - if `POST` data length is less that `action.maxPostSize` then it is `true` else `false`\n\n### Response Methods\n\n * `response.req` - request related tu current request\n * `response.get(headerName)` - return a header value\n * `response.append(headerName, val)` - add value to a header, if header is already set, append second same header\n * `response.location(url)` - add headers for redirect by url\n * `response.clearCookie(name, options) - removing a coockie\n * `response.cookie(name, val, options) - addinf a cookie\n * `options.signed` - if true, hash the cookie\n * `options.expires` - absolute expiration date for the cookie (Date object)\n * `options.path` - cookie path\n * `options.maxAge` - relative max age of the cookie from when the client receives it (seconds)\n * `options.domain` - domain for the cookie\n * `options.secure` - true or false\n * `options.httpOnly` - true or false\n * `response.pipe(filePath, callback, request)`\n _piping a file from_ `filePath` _to_ `response`\n `response` _is not closed/ended_\n `callback` _captures `err` in case of in-success_ `function (err) { /*...*/ }`\n `request` _is optional ( used for `Content-Range` header)_\n * `response.download(filePath, fileName, callback, request)`\n _piping a file from_ `filePath` _to_ `response`\n `fileName` _filename for downloaded file_\n `response` _is not closed/ended_\n `callback` _captures `err` in case of in-success_ `function (err) { /*...*/ }`\n `request` _is optional ( used for `Content-Range` header)_\n * `response.staticResource(filePath, fileName, callback, request)`\n _piping a file from_ `filePath` _to_ `response`\n `fileName` _filename for returned file_\n `response` _is not closed/ended_\n `callback` _captures `err` in case of in-success_ `function (err) { /*...*/ }`\n `request` _is optional ( used for `Content-Range` header)_\n\n\n## Templates Env references\n\n```js\nvar app = require(\"nodejs-mvc\")();\n\napp.templateEnv({\n\tauthor: \"sergiu-gordienco\"\n});\n\n// in templates will be available a reference env with data { author: \"sergiu-gordienco\" }\n```\n\n## application viewer - Viewer Object\n\nSmall overview\n\n```js\n\tdebugMode\t: function (status) {\n\t\t// updates or just return current debug status\n\t},\n\tgetEnvVars\t: function() {\n\t\t// return envVars;\n\t},\n\tupdateEnvVars\t: function( data ) {\n\t\t// updates env vars\n\t},\n\trenderCode\t: function (code, vars, virtualFilePath, cb) {\n\t\t// code - the code to e rendered\n\t\t// vars - this reference will be available in template as \"vars\"\n\t\t// virtualFilePath - reference path that will be used for searching included files\n\t\t// cb - callback for getting results\n\t\t\t// arguments:\n\t\t\t\t// error - ( Array of errors ) or ( undefined )\n\t\t\t\t// html - String code\n\t}\n```\n\n## Email Object\n\n## Examples\n```js\n\tvar app = require(\"nodejs-mvc\");\n\tvar Email = app.Email\n\tvar myMsg = new Email(\n\t{ from: \"me@example.com\"\n\t\t, to: \"you@example.com\"\n\t\t, subject: \"Knock knock...\"\n\t\t, body: \"Who's there?\"\n\t});\n\n\t// if callback is provided, errors will be passed into it\n\t// else errors will be thrown\n\tmyMsg.send(function(err){ ... })\n```\n\nNote that no callback was passed into `send()`, therefore errors will throw.\n\n## Options\n\n```js\n\tnew Email(config)\n```\n\nconfig options:\n\n- to {array|string}\n - Email address(es) to which this msg will be sent\n- from {string}\n - Email address from which this msg is sent. If not set\n defaults to the `exports.from` global setting.\n- replyTo {string}\n - Email address to which replies will be sent. If not set\n defaults to `from`\n- cc {array|string}\n - Email address(es) who receive a copy\n- bcc {array|string}\n - Email address(es) who receive a blind copy\n- subject {string}\n - The subject of the email\n- body {string}\n - The message of the email\n- bodyType {string}\n - Content type of body. Only valid option is 'html' (for now).\n Defaults to text/plain.\n- altText {string}\n - If `bodyType` is set to 'html', this will be sent as the text\n alternative.\n- timeout {number}\n - Duration in milliseconds to wait before killing the process.\n If not set, defaults to `exports.timeout` global setting.\n- path {string}\n - Optional path to the sendmail executable\n- debug {boolean}\n - Print debug info\n\n\n## TODO documentation for following objects\n\napp.debug\napp.console\napp.templateManager\napp.getVars\napp.maxPostSize\napp.onMaxPostSize\napp.sessionManager\napp.\\_events // .onError\napp.httpStatuses\n\nappInstance.\\_functions.isValidIdentifier\nappInstance.structure\nappInstance.sessionExpire\nappInstance.templateEnv\nappInstance.sessionAutoUpdate\nappInstance.getPublicPath\nappInstance.getRootPath\nappInstance.getLibPath\nappInstance.getVendorPath\nappInstance.viewer\n\n\n## Templates FaceboxTPL\n\n### To view parameters that are send have following structure\n\nOn template Rendering we have following variables\n\n```javascript\n\n\t// variables that a sent from controllers\n\tvar vars\t= {};\n\n\tvar env\t\t= {\n\t\terror\t: [],\n\t\tvars\t: envVars,\n\t\tpath\t: \"\", // file path of current rendered template\n\t\tdirname\t: \"\", // dirname of current rendered template\n\t\trender\t: function( text, vars, env ) {}, // render function\n\t\trenderFile\t: function( file, vars, callback ) {}, // render file function\n\t\t\t// callback( error {{ [] or false }}, htm)\n\t};\n\n\t// env vars sent from app\n\tenv.vars = {\n\t\tresponse : [object] // http response object\n\t}\n```\n\n### An example how to render a view:\n\n```javascript\n\n\t// file app/modules/index/controller/pageviews.js\n\n\t// file represents action page-views from controller index\n\tvar _vars\t= {\n\t\tpageviews\t: 0\n\t};\n\tmodule.exports\t= {\n\t\tpublic\t: true,\n\t\tcapture\t: function( request, response, app, controller, action ) {\n\t\t\t// increasing page-views\n\t\t\t// sending page-views to view\n\t\t\tcontroller.render( response, 'index', { pageviews: (++_vars.pageviews) });\n\t\t}\n\t};\n```\n\n### Operation in templates\n\n#### Include another template\n\n```html\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t{{read:license.txt}}\n\t