feat(#29): add CORS support

Author: h2non

README.md

@@ -499,8 +499,8 @@ toxy.poison(toxy.poisons.abort())
 // Abort after a delay
 toxy.poison(toxy.poisons.abort(1000))
 // In this case, the socket will be closed if
-// the target server doesn't replies with
-// a response after 2 seconds
+// the target server takes more than
+// 2 seconds to respond
 toxy.poison(toxy.poisons.abort({ delay: 2000, next: true }))
 ```
 
@@ -1183,7 +1183,7 @@ For a featured use case, see the [admin server](examples/admin.js) example.
 const toxy = require('toxy')
 
 // Create the toxy admin server
-var admin = toxy.admin()
+var admin = toxy.admin({ cors: true })
 admin.listen(9000)
 
 // Create the toxy proxy
@@ -1408,8 +1408,10 @@ Returns: `Admin`
 
 **Supported options**:
 
-- **apiKey** - Optional API key to protect the server
-- **port** - Optional. TCP port to listen
+- **apiKey** `string` - Optional API key to protect the server
+- **port** `number` - Optional. TCP port to listen
+- **cors** `boolean` - Enable CORS for web browser access
+- **middleware** `array<function>` - Plug in additional middleware
 
 ##### Admin#listen([ port, host ])
 

examples/admin.js

@@ -34,7 +34,7 @@ proxy.listen(3000)
 console.log('Server listening on port:', 3000)
 
 // Enable the admin HTTP server
-var admin = toxy.admin(/* { apiKey: 's3cr3t' } */)
+var admin = toxy.admin({ cors: true })
 
 // Add the toxy proxy instance
 admin.manage(proxy)

lib/admin/index.js

@@ -19,6 +19,16 @@ module.exports = function (opts) {
   admin.use(middleware.reply)
   admin.use(middleware.authorization)
 
+  if (opts.cors) {
+    admin.use(middleware.cors)
+  }
+
+  if (opts.middleware) {
+    opts.middleware.forEach(function (middleware) {
+      admin.use(middleware)
+    })
+  }
+
   /**
    * Configure param-based middleware
    */

lib/admin/middleware/index.js

@@ -1,5 +1,6 @@
 module.exports = {
   body: require('./body'),
+  cors: require('./cors'),
   admin: require('./admin'),
   reply: require('./reply'),
   authorization: require('./authorization')

lib/proxy.js

@@ -162,7 +162,8 @@ function getPoisonsStack(proxy, phase) {
 }
 
 function createPoison(poison) {
-  return (poison instanceof Poison)
-    ? poison
-    : new Poison(poison)
+  if (poison instanceof Poison) {
+    return poison
+  }
+  return new Poison(poison)
 }