http-routes

http-routes

functional http router using http-compose and path-to-regexp

npm install --save http-routes

example

const Server = require('http').createServer
const Cookie = require('cookie')
const Send = require('http-sender')()
const Route = require('http-routes')

const routerHandler = Route([
  Route([
    // login and set cookies
    ['/login/:id', function login (req, res, context, next) {
      res.setHeader('Set-Cookie', Cookie.serialize('id', context.params.id, { path: '/' }))
      res.setHeader('Location', '/whoami') // redirect to the whoami page.
      res.statusCode = 303
      res.end()
    }],
    // logout and clear cookies
    ['/login', {
      get: function view (req, res, context, next) {
        const newId = Math.random().toString(8).substring(2)
        const html = `<a href='/login/${newId}'>login!</a>`
        res.setHeader('Content-Type', 'text/html')
        next(null, html)
      }
    }],
    Route(['/logout', function logout (req, res, context, next) {
      res.setHeader('Set-Cookie', Cookie.serialize('id', '', { path: '/' }))
      res.setHeader('Location', '/whoami') // redirect to the whoami page
      res.statusCode = 303
      res.end()
    }])
  ]),
  // check cookies, and authorize this connection (or not)
  function authorize (req, res, context, next) {
    context.id = Cookie.parse(req.headers.cookie).id || null
    next()
  },
  // return list of the current access rights. (for debugging)
  Route('/whoami', function whoami (req, res, context, next) {
    res.setHeader('Content-Type', 'application/json')
    next(null, context.id)
  })
])

Server((req, res) => {
  routerHandler(req, res, {}, Send(req, res))
}).listen(5000)

usage

Route = require('http-routes')

handler = Route(path, routeHandler(s))

handler = Route([path, routeHandler(s)])

handler = Route([[path, routeHandler(s)], ...])

where path is an Express-style path for path-to-regexp

and handler is a function of shape (req, res, context, next) => { next(err, value) } for http-compose

and routeHandler is a handler where context.params is an object of path matches and context.url is substring of original url after path match

and routeHandlers is an object mapping http method names to route handler functions.

license

The Apache License

Copyright © 2016 Michael Williams

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.