billy-http-express

A Billy service that creates an Express 4 HTTP server.

Install

$ npm install billy-http-express

Usage

var Application = require('billy');
var HttpService = require('billy-http-express');

var app = new Application();
app.service(HttpService);
app.config('http.port', 8889);

app.start();

The actual server is started after all services have been loaded, so registering any middleware or setting up of express should happen after this service via the http dependencies.

app.service(function MyWebService(http) {
  http.use(cookieParser());
  http.get('/', function(req, res) {
    res.send('Hello, World!');
  });
});

This can be done in a separate service following this one, or via specifying a module via the http.server config.

Injectables

New dependencies that you can use after adding this service:

tag | type |description | notes -----|------|------------|------- http | express | The express application | Setup routes, middleware, etc with this object

Configs

Available config properties:

config | type | description | default value | notes --------|------|-------------|---------------|------ http.port | number | Port to listen on for HTTP connections | process.env.PORT, 8123 1 | http.secret | string | Server-side secret | 'supersecret' | Used for securing cookies. http.webroot | string | Path to directory of static files to serve | null | Optional. If not set, will not start the static server. If an array, will serve multiple directories2 http.server | function | Server startup module | null | Optional IoC-injected module to start when the server is created. 3 http.username | string | HTTP basic auth username | process.env.HTTP_USERNAME, null | If null, any username will be accepted. 4 http.password | string | HTTP basic auth password | process.env.HTTP_PASSWORD, null | If null, any password will be accepted. 4

1 Will use the PORT environment variable if available, e.g. on Heroku.

2 The static server is mounted during the start phase of this service, meaning all middleware mounted in the setup / constructor function of other services will have precedence, as will any services that start before this one.

3 The http.server module must be set before the app is started since it is booted with the HTTP service starts.

4 Basic auth will only be enabled if either http.username or http.password is set

Testing

$ npm test

License

MIT