falconer

#Node Falconer

Usage

Falconer = require('falconer').Falconer

// Create a Falconer instance for the upstream application
var upstreamApp = new Falconer({
	host: 'myApp.example.com',
	port: 80
});

// The falconer client will proxy express/connect requests to your upstream app
var app = require('express').createServer();
// or
// var app = require('connect').createServer();

// Add the client as a middleware to your app to enable proxy
app.use(upstreamApp);
app.listen(4000);

// The falconer client will emit any events received from the upstream app
upstreamApp.on('someUpstreamEvent', function(payload1, payload2){
	// handle events from upstream app
});

// You can also easily send HTTP requests to the upstream app
// These will also query for events from the upstream app
upstreamApp.get('/some/endpoint.json').complete(function(response){
	// response is an http.ClientResponse
	// response.body contains response body as a string
});

// More requests
upstreamApp.post('/users.json').
	.json({user: {name: 'Jim Hoskins'}})
	.header('Accept', 'text/html, */*')
	.header({
		'Cookie': 'name=value',
		'custom-header': 'value'
	})
	.on('response', function(res){
		// before response data events
	})
	.complete(function(res){
		// response after response end event. 
		// includes response.body
	});