contextualize

A simple tool for lazily bootstrapping any nodejs app into each application context.

contextualize

A simple tool for lazily bootstrapping any nodejs app into each application context.

contextualize creates an http server for you and provides a mechanism for defining the context for each request, and a mechanism for bootstrapping an application for each unique context.

var contextualize = require('contextualize');
 
contextualize()
    .context(function(requestdone) {
        // Set the context for this request 
        done(null, { foo:'bar' });
    })
    .bootstrap(function(contextdone) {
        // Bootstrap an application for a context 
        done(null, function(reqres) {
            res.end('Hello World');
        });
    })
    .listen(80);

Here is an example of how you might switch contexts based on environment and locale code in the host name:

contextualize()
    .context(function(requestdone) {
        // Extract the environment and locale code from the host name (e.g. prod.en-US.foobar.com) 
        var m = request.host.match(/^(\w+)\.([a-z]{2}-[A-Z]{2})\./);
        
        // Return the context 
        done(null, {
            environment: m[1],
            locale: m[2]
        });
    })
    .bootstrap(function(contextdone) {
        // Bootstrap an application for each unique context 
        done(null, new Application(context));
    })
    .listen(80);

By default the first request in a context will take the hit of bootstrapping the application for that context. If you want to preload known contexts to avoid that latency on the first request then you can use the preload method:

contextualize()
    .context(getContext)
    .bootstrap(bootstrapApp)
    .preload([{
        locale: 'en-US',
        environment: 'prod'
    }, {
        locale: 'pt-BR',
        environment: 'prod'
    }])
    .listen(80);

You may want to apply some middleware (e.g. static file serving, cookie parsing, body parsing, user authentication, etc.) prior to setting the context for a request.

contextualize()
    // Attach middleware here 
    .use(staticMiddleware('./public', './static'))
    .use(authMiddleware())
    .context(function(requestdone) {
        // Use result of authentication middleware in the context 
        done(null, {
            authorized: request.authorized,
        });
    })
    .bootstrap(function(contextdone) {
        // Bootstrap seperate apps for logged in or not logged in users 
        done(null, context.authorized ? new PublicApplication() : new PrivateApplication());
    })
    .listen(80);

Applications returned by your bootstrap function are either a Function or an Object with a handleRequest method.

contextualizer()
    .context(getContext)
    .bootstrap(function(contextdone) {
        done(null, function(reqres) {
            res.end('Hello World');
        });
    });
    .listen(80);

or:

contextualizer()
    .context(getContext)
    .bootstrap(function(contextdone) {
        done(null, {
            handleRequestfunction(reqres) {
                res.end('Hello World');
            }
        });
    })
    .listen(80);

Note that express and connect applications are already functions with this interface so this will work as well:

contextualizer()
    .context(getContext)
    .bootstrap(function(contextdone) {
        var app = require('express')();
 
        app.get('/sup', function(reqres){
            res.send(200, 'Hello World');
        });
 
        done(null, app);
    })
    .listen(80);