X-Git-Url: https://git.kengrimes.com/?p=henge%2Fkiak.git;a=blobdiff_plain;f=router.js;h=da11e8a736b46d35c3517fa8b4cbe58a0982d6d7;hp=f17964b191446c3ce77b25c7e6d8ad512f2d667d;hb=c2c2c7b9b8be9a2e11576e8d26d044319019ad1d;hpb=4ac972b80f19f55c2e221cda7c8a6aee920891be diff --git a/router.js b/router.js index f17964b..da11e8a 100644 --- a/router.js +++ b/router.js @@ -6,75 +6,248 @@ * @license AGPL-3.0 * @copyright Strapp.io */ -const fs = require('fs') const dlog = (msg) => console.log(msg) exports = { /** Regular expression for valid routes - * @var {Object.RegEx} validRoutes - matches valid route names + * @prop {Object.RegEx} validRoutes - matches valid route names */ validRoutes: /[a-zA-Z][a-zA-Z0-9\-_]*/, - /** @func - * @summary Synchronize Reading Multiple Files - * @desc reads an array of files into an object, whose keys are the - * input filenames, and values are the data read - * @arg {string[]} files - array of file names to read - * @arg {Object} [readOpts] - options to pass to fs.readFile() + /** Parameters set on bootup (startHttpServer) + * @prop {string[2]} skelPage - html document split in twain for JS injection + * @prop {string} clientJS - jerverscripps to inject in skelPage for clients + * @prop {string} hostJS - jerverscripps for the hosts + * @prop {string} httpdRoot - a normalized path for http-servable files + * @prop {string} bindJail - jail bindings to this path */ - syncReads: (files, readOpts) => new Promise((resolve,reject) => { - dlog(`syncReads: ${files}`) - let count = 0 - let results = {} - const read_cb = (fileName) => (err, data) => { - if (err) - reject(err) - else - results[fileName] = data - if (++count == files.length) - resolve(results) + skelPage: undefined, + clientJS: undefined, + hostJS: undefined, + httpdRoot: undefined, + bindJail: undefined, + + + + /** @func + * @summary Start main HTTP server + * @desc starts up an HTTP or HTTPS server used for routing + * @arg {Object} conf - object containing configuration properties + * @prop {number|string} conf.port - local system port to bind to + * @prop {string} conf.skelFile - location of the skeleton HTML page + * @prop {string} conf.clientJS - client JS file + * @prop {string} conf.hostJS - host JS file + * @prop {string} [conf.httpdRoot] - root path of http-accessible files, if + * undefined no files are accessible + * @prop {Object} [conf.tls] - if present, startHttpServer will use tls + * @prop {string} [conf.tls.certFile] - tls certificate file + * @prop {string} [conf.tls.keyFile] - tls public key file + */ + startHttpServer: function (conf) { + if ('httpd' in this) + throw new Error('httpd already running') + if (conf.tls == undefined) + this.httpd = require('http').createServer(this.httpdListener) + else if (!('keyFile' in conf.tls) || !('certFile' in conf.tls)) + throw new Error('HTTPS requires a valid key and cert') + else + this.syncReads([conf.tls.keyFile, conf.tls.certFile]).then((results) => { + Object.defineProperty(this, 'httpsOpts', { + value: { + key: results[conf.tls.keyFile], + cert: results[conf.tls.certFile] + } + }) + this.httpd = + require('https').createServer(this.httpsOpts, this.httpdListener) + }) + this.httpd.listen(conf.port) + this.httpdRoot = + conf.httpdRoot ? require('path').normalize(conf.httpdRoot) : undefined + while (this.httpdRoot[this.httpdRoot.length - 1] == require('path').sep) + this.httpdRoot = this.httpdRoot.slice(0,-1) + this.syncReads(conf.skelFile, conf.clientJS, conf.hostJS) + .then((results) => { + this.skelPage = results[conf.skelFile].split('') + this.clientJS = results[conf.clientJS] + this.hostJS = results[conf.hostJS] + }) + .catch((err) => { + console.log(err) + }) + console.log(`HTTP${(conf.tls == undefined) ? 'S' : ''} ` + + `Server Started on port ${conf.port}${this.httpdRoot ? + `, serving files from ${this.httpdRoot}`:''}`) + }, + + /** @func + * @summary Create a binding for the server + * @desc makes a new route which is bound to a file or a path. routes + * bound to files always serve that file, regardless of any + * additional path parameters provided by the URI + * @arg {string} routeName - the route to create + * @arg {string} path - the path to the file or directory to bind + */ + createBind: function (routeName, path) { + dlog(`Binding ${routeName} to ${path}`) + if (routeName in this.routes) + throw new Error(`route ${routeName} already exists`) + path = require('path').normalize(path) + if (this.bindJail + && path.indexOf(`${this.bindJail}/`) !== 0 + && this.bindJail != path) + throw new Error(`${routeName}:${path} jailed to ${this.bindJail}`) + if (require('fs').existsSync(path)) { + this.route[routeName] = { + bind: { + path: path, + dir: require('fs').lstatSync(path).isDirectory() + } + } } - if (readOpts == undefined) - readOpts = { encoding: 'utf8' } - files.forEach((file) => fs.readFile(file, readOpts, read_cb(file))) - }), - + else + throw new Error(`${path} not found, ${routeName} not bound`) + }, + /** @func - * @summary Main router listener - * @desc listens for client requests and services routes/files - * @arg {http.ClientRequest} request - * @arg {http.ServerResponse} response + * @summary Router + * @desc listens for http client requests and services routes/files + * @arg {http.ClientRequest} request + * @arg {http.ServerResponse} response */ - listener: function (request,response) { + httpdListener: function (request,response) { dlog(`Received request ${request.method} ${request.url}`) - const htArgv = request.url.slice(1).split('?') - let routePath = htArgv[0].split('/')[0] - let routeName = routePath[0] - let route = this.routes[routeName] + let htArgv = request.url.slice(1).split('?') + const routeName = htArgv[0].split('/')[0] + const route = this.routes[routeName] + /* If the route exists, check if we are a returning host or a new client */ if (route) { - if (route.host == (request.headers['x-forwarded-for'] || + if (route.bind) { + htArgv[0] = htArgv[0].replace(`${routeName}`,'') + if (htArgv[0][0] === '/') + htArgv[0] = htArgv[0].slice(1) + this.serveBind(response, route.bind, htArgv) + } + else if (route.host == (request.headers['x-forwarded-for'] || request.connection.remoteAddress)) this.serveHost(response, route, htArgv) else - this.serveRoute(response, route) + this.serveClient(request, response, route) } + /* If it's a valid routename that doesn't exist, make this client a host */ else if (this.validRoutes.test(routeName)) { route = this.createRoute(routeName, this.httpsOpts) this.serveHost(response, route, htArgv) } + /* Try servicing files if we have a root directory for it */ + else if (this.httpdRoot) { + let realPath = require('path').join(this.httpdRoot, htArgv[0]) + if (realPath == this.httpdRoot) + realPath += '/index.html' + if (realPath.indexOf(`${this.httpdRoot}/`) == 0) { + const stat_cb = (err, stat) => { + if (err) { + response.writeHead(404) + response.end() + console.log(err) + } + else if (stat.isDirectory()) { + realPath += '/index.html' + require('fs').lstat(realPath, stat_cb) + } + else if (stat.isFile()) + this.serveFile(response, realPath) + else { + response.writeHead(403) + response.end() + } + } + require('fs').lstat(realPath, stat_cb) + } + else { + response.writeHead(400) + response.end() + } + } + /* Unhandled */ else { - this.serveFile(response, routePath) + response.writeHead(404) + response.end() + } + }, + + /** @func + * @summary Serves a binding to a client + * @desc Resolves a binding and serves a response to the client + * @arg {http.ServerResponse} response - the response to use + * @arg {Object} bind - the binding to serve the client + * @arg {string[]} argv - path and arguments for the bind + */ + serveBind: function (response, bind, argv) { + dlog(`Serving binding ${bind.path}/${argv[0]}`) + if (bind.dir) { + if (argv[0] == '') + argv[0] = 'index.html' + this.serveFile(response, require('path').join(bind.path, argv[0])) } + else + this.serveFile(response, bind.path) }, /** @func * @summary Serve a route to an http client * @desc routes may be bound to the filesystem, or to an outgoing host + * @arg {http.ClientRequest} request - request from the client + * @arg {http.ServerResponse} response - response object to use + * @arg {Object} route - route associated with client request + */ + serveClient: function (request, response, route) { + const type = request.headers['x-strapp-type'] + const pubKey = request.headers['x-strapp-pubkey'] + dlog(`Client ${type || 'HT'} request routed to ${route.name}`) + switch (type) { + case null: + case undefined: + response.writeHead(200, { 'Content-Type': 'text/html' }) + response.write(`${this.skelPage[0]}${this.clientJS}${this.skelPage[1]}`) + response.end() + break + case 'ice-candidate-request': + case 'ice-candidate-submission': + case 'client-sdp-offer': + let data = '' + if (pubKey) { + route.pendingResponses.addResponse(pubKey, response) + request.on('data', (chunk) => data += chunk) + request.on('end', () => route.socket.send(`${pubKey} ${type} ${data}`)) + } + else { + response.writeHead(401) + response.end() + } + break + default: + response.writeHead(400) + response.end() + } + }, + + /** @func + * @summary Serve a route to an authorized http host + * @desc services host application to the client, establishing a socket * @arg {http.ServerResponse} response - response object to use - * @arg {string} routeName - name of the route to follow + * @arg {Object} route - the route that belongs to this host + * @arg {string[]} argv - vector of arguments sent to the host */ - serveRoute: function (response, routeName) { + serveHost: function (response, route, argv) { + response.writeHead(200, { 'Content-Type': 'text/html' }) + response.write(`${this.skelPage[0]}` + + `\tconst _strapp_port = ${route.port}\n` + + `\tconst _strapp_protocol = ` + + `${this.httpsOpts ? 'wss' : 'ws'}'\n` + + `${this.hostJS}\n${this.skelPage[1]}`) + response.end() }, /** @func @@ -84,6 +257,7 @@ exports = { * @arg {string} host - Origin address from the request that made this * route (for security verification on the socket) * @arg {Object} [httpsOpts] - key and cert for tls + * @returns {Object} a route object containing host, socket, and servers */ createRoute: function (routeName, host, httpsOpts) { dlog(`Creating ${httpsOpts ? 'TLS ' : ''}route ${routeName} from ${host}`) @@ -92,21 +266,31 @@ exports = { const httpd = httpsOpts ? require('https').createServer(httpsOpts) : require('http').createServer() - const wsd = new require('ws').Server({ - server: httpd, - verifyClient: (info) => info.origin == host && (info.secure || !httpsOpts) - }) const route = { pendingResponses: new Map([]), host: host, httpd: httpd, - wsd: wsd, name: routeName, + port: undefined, + wsd: undefined, socket: undefined } - wsd.on('connection', (socket) => - socket.on('message', (msg) => - this.hostMessage(msg,route))) + require('get-port')().then((port) => { + route.port = port + route.httpd.listen(port) + route.wsd = new require('ws').Server({ + server:route.httpd, + verifyClient: (info) => + info.origin == host && (info.secure || !httpsOpts) + }) + route.wsd.on('connection', (socket) => + socket.on('message', (msg) => + this.hostMessage(msg,route))) + }) + route.pendingResponses.addResponse = function (key, response) { + let responses = this.get(key) || [] + this.set(key, responses.push(response)) + } this.routes[routeName] = route return route }, @@ -117,9 +301,12 @@ exports = { * and responds to either the host or the client, or both. Commands * are whitespace separated strings. * Commands: - * < clientKey requestID payload - * Route 'payload' to the client identified by 'clientKey', in - * response to the request identified by 'requestID' + * < clientKey payload [header] + * Route 'payload' to the client identified by 'clientKey'. + * The optional 'header' argument is a stringified JSON object, + * which will be written to the HTTP response header + * In case of multiple requests from a single client, the + * oldest request will be serviced on arrival of message * ! errorMessage errorCode [offendingMessage] * Notify host that an error has occured, providing a message * and error code. 'offendingMessage', if present, is the @@ -134,18 +321,23 @@ exports = { dlog(`Received host message from ${route.name}: ${command}`) switch (command) { case '<': - if (argv.length == 3) { - const response = route.pendingResponses.get(argv[0] + argv[1]) - response.writeHead(200, { 'Content-Type': 'application/octet-stream' }) - response.write(argv[2]) + const response = route.pendingResponses.get(argv[0]).shift() + if (!response) + route.socket.send(`! "No pending responses for client ${argv[0]}" 0 ` + + message) + else if (argv.length === 2 || argv.length === 3) { + const header = argv.length === 3 ? JSON.parse(argv[2]) : {} + if (!('Content-Type' in header)) + header['Content-Type'] = 'application/octet-stream' + response.writeHead(200, header) + response.write(argv[1]) response.end() } - else { + else route.socket.send(`! "Insufficient arguments" 0 ${message}`) - } break case '!': - if (argv.length == 3) + if (argv.length === 3) argv[0] += `\nIn message: ${argv[2]}` console.log(`Error[${route.host}|${argv[1]}]:${argv[0]}`) break @@ -157,201 +349,47 @@ exports = { * @desc reads files from the system to be distributed to clients, and * buffers recently accessed files * @arg {http.ServerResponse} response - the response object to use - * @arg {string} filePath - location of the file on disk to service + * @arg {string} filePath - relative location of the file */ - serveFile: function (response, filePath) { + serveFile: function (response, filePath, rootPath) { + //TODO: Make a buffer to hold recently used files, and only read if we + // have to (don't forget to preserve mimetype) + require('fs').readFile(filePath, { encoding: 'utf8' }, (err, data) => { + if (err || data == undefined) + response.writeHead(404) + else { + response.writeHead(200, { + 'Content-Type': require('mime').lookup(filePath) + }) + response.write(data) + } + response.end() + }) }, - - /** @func - * @summary Start main HTTP server - * @desc starts up an HTTP or HTTPS server used for routing - * @arg {number|string} port - local system port to bind to - * @arg {Object} [tls] - if present, startHttpServer will start in tls - * mode. supported properties: - * 'certfile': certificate file location - * 'keyfile': key file location + + /** @func + * @summary Synchronize Reading Multiple Files + * @desc reads an array of files into an object, whose keys are the + * input filenames, and values are the data read + * @arg {string[]} files - array of file names to read + * @arg {Object} [readOpts] - options to pass to fs.readFile() */ - startHttpServer: function (port, tls) { - if ('httpd' in this) - throw new Error('httpd already running') - if (tls == undefined) - this.httpd = require('http').createServer(this.listener) - else if (!('key' in tls) || !('cert' in tls)) - throw new Error('HTTPS requires a valid key and cert') - else - this.syncReads([tls.keyfile, tls.certfile]).then((results) => { - Object.defineProperty(this, 'httpsOpts', { - value: { - key: results[tls.keyfile], - cert: results[tls.certfile] - } - }) - this.httpd = require('https').createServer(httpsOpts, this.listener) - }) - this.httpd.listen(port) - console.log(`HTTP${(tls == undefined) ? 'S' : ''} ` + - `Server Started on Port ${port}`) - } + syncReads: (files, readOpts) => new Promise((resolve,reject) => { + dlog(`syncReads: ${files}`) + let count = 0 + let results = {} + const read_cb = (fileName) => (err, data) => { + if (err) + reject(err) + else + results[fileName] = data + if (++count === files.length) + resolve(results) + } + if (readOpts == undefined) + readOpts = { encoding: 'utf8' } + files.forEach((file) => + require('fs').readFile(file, readOpts, read_cb(file))) + }) + } - -// exports.create = (opts) => { return { -// opts: opts, -// listener: function (request, response) { -// console.log('server handling request') -// const serveFile = (fPath) => { -// fs.readFile(fPath, { encoding: 'utf8' }, (err, data) => { -// if (err || data == undefined) { -// response.writeHead(404) -// response.end() -// } -// else { -// response.writeHead(200, { 'Content-Type': mime.lookup(fPath) }) -// response.write(data) -// response.end() -// } -// }) -// } -// const htArgv = request.url.slice(1).split("?") -// let routePath = htArgv[0].split('/') -// let routeName = routePath[0] - - -// if (routeName === '' || routeName === 'index.html') -// serveFile(opts['index']) -// else if (routeName in opts['bindings']) { -// let localPath = path.normalize(opts['bindings'][routeName].concat(path.sep + routePath.slice(1).join(path.sep))) -// if (localPath.includes(opts['bindings'][routeName])) { -// fs.readdir(localPath, (err, files) => { -// if (err) -// serveFile(localPath) -// else -// serveFile(`${localPath}/index.html`) -// }) -// } -// else { -// console.log(`SEC: ${localPath} references files not in route`) -// } -// } -// /* TODO: Handle reconnecting host */ -// else if (routeName in router.routes) { -// const route = router.routes[routeName] -// const clients = route['clients'] -// const headerData = request.headers['x-strapp-type'] - - - - -// /* Client is INIT GET */ -// if (headerData === undefined) { -// console.log('client init GET') -// response.writeHead(200, { 'Content-Type': 'text/html' }) -// response.write(`${router.skelPage[0]}${router.clientJS}${router.skelPage[1]}`) -// response.end() -// //TODO: if route.socket == undefined: have server delay this send until host connects -// // (this happens when a client connects to an active route with no currently-online host) -// } -// else if (headerData.localeCompare('ice-candidate-request') === 0) { -// console.log('Server: received ice-candidate-request from Client') -// let pubKey = request.headers['x-client-pubkey'] -// clients.set(pubKey, response) -// pubKey = '{ "pubKey": "' + pubKey + '" }' -// route.socket.send(pubKey) -// } -// else if (headerData.localeCompare('ice-candidate-submission') === 0) { -// console.log('Server: recieved ice-candidate-submission from Client') -// let data = [] -// request.on('data', (chunk) => { -// data.push(chunk) -// }).on('end', () => { -// console.log('Sending ice-candidate-submission to Host') -// data = Buffer.concat(data).toString(); -// clients.set(JSON.parse(data)['pubKey'], response) -// route.socket.send(data) -// }) -// } -// else if (headerData.localeCompare('client-sdp-offer') === 0){ /* Client sent offer, waiting for answer */ -// console.log('Server: Sending client offer to host') -// clients.set(JSON.parse(request.headers['x-client-offer'])['pubKey'], response) -// route.socket.send(request.headers['x-client-offer']) -// } else { -// console.log('Unhandled stuff') -// console.log(request.headers) -// } - -// } -// else { -// router.routes[routeName] = true -// const newRoute = {} -// newRoute.clients = new Map([]) -// newRoute.host = request.headers['x-forwarded-for'] || request.connection.remoteAddress -// getport().then( (port) => { -// newRoute.port = port -// if (opts['no-tls']) -// newRoute.httpd = http.createServer() -// else -// newRoute.httpd = https.createServer(router.httpsOpts) -// newRoute.httpd.listen(newRoute.port) -// newRoute.wsd = new ws.Server( { server: newRoute.httpd } ) -// newRoute.wsd.on('connection', (sock) => { -// console.log(`${routeName} server has been established`) -// newRoute.socket = sock - -// /* Handle all messages from host */ -// sock.on('message', (hostMessage) => { -// hostMessage = JSON.parse(hostMessage) -// response = newRoute.clients.get(hostMessage['clientPubKey']) - -// /* If the host response is a answer */ -// if (hostMessage['cmd'].localeCompare('< sdp pubKey') === 0) { -// console.log('Server: Sending host answer to client') -// response.writeHead(200, { 'Content-Type': 'application/json' }) -// response.write(JSON.stringify(hostMessage)) -// response.end() -// } -// else if (hostMessage['cmd'].localeCompare('< ice pubKey') === 0){ -// /* if the host response is an ice candidate */ -// console.log('Server: Handling host ICE message') -// let iceState = hostMessage['iceState'] -// /* If there are any ice candidates, send them back */ -// switch(iceState) { -// case "a": -// response.writeHead('200', {'x-strapp-type': 'ice-candidate-available'}) -// response.write(JSON.stringify(hostMessage)) -// response.end() -// break -// case "g": -// console.log('Server: Host is still gathering candidates, keep trying') -// response.writeHead('200', {'x-strapp-type': 'ice-state-gathering'}) -// response.write(JSON.stringify(hostMessage)) -// response.end() -// break -// case "c": -// console.log('Server: Host has completed gathering candidates') -// response.writeHead('200', {'x-strapp-type': 'ice-state-complete'}) -// response.write(JSON.stringify(hostMessage)) -// response.end() -// break -// default: -// console.log('unhandled iceState from host') -// break -// } -// } - -// }) -// }) - -// console.log(`Listening for websocket ${newRoute.host} on port ${newRoute.port}`) -// router.routes[routeName] = newRoute -// }).then(() => { -// response.writeHead(200, { 'Content-Type': 'text/html' }) -// response.write(`${router.skelPage[0]}` + -// `\tconst _strapp_port = ${newRoute.port}\n` + -// `\tconst _strapp_protocol = '${router.wsProtocol}'\n` + -// `${router.hostJS}\n${router.skelPage[1]}`) -// response.end() -// }) -// } -// }, -// startHttpd: () => require('http').createServer(this.listener) -// } -