heroku-proxy

heroku-proxy provides a proxy to the Heroku API for express apps. It is intended for use with node-heroku-bouncer.

Install

$ npm install heroku-proxy --save

Use

heroku-proxy assumes that it has the node-heroku-bouncer middleware in front of it. See the node-heroku-bouncer README for configuration instructions.

var express     = require('express');
var herokuProxy = require('heroku-proxy');
var app         = express();

// ...set up heroku-bouncer

app.use(herokuProxy());

By default, heroku-proxy will proxy all requests to /api/* of any method to api.heroku.com via https. You can override the default options by passing an object into the function returned by the heroku-proxy module:

app.use(herokuProxy({
  hostname: 'localhost',
  port    : 5001,
  prefix  : 'heroku-api',
  protocol: 'http'
}));

Now, a request to /heroku-api/apps will be proxied to http://localhost:5001/apps.

Options

| Option | Effect | Default | | -------- | ------ | ------- | | log | Log request details | false | | hostname | The hostname to proxy requests to | api.heroku.com | | port | The port on API host | 443 | | prefix | A prefix path where your Express app will be listening for API requests | api | | protocol | The protocol to use | https | | whitelistHeaders | Additional headers to whitelist to pass through to the API | [] | | headerTransforms | An object of keys (from) and values (to) to transform request headers before being sent to the API | {} |

Test

$ npm test