Expose busboy options, update docs and tests.

.gitignore

@@ -35,3 +35,6 @@ jspm_packages
 
 # Optional REPL history
 .node_repl_history
+
+# Ignore package-lock
+package-lock.json

README.md

@@ -57,6 +57,39 @@ fastify.listen(3000, err => {
 })
 ```
 
+You can also pass optional arguments to busboy when registering with fastify. This is useful for setting limits on the content that can be uploaded. A full list of available options can be found in the [busboy documentation](https://github.com/mscdex/busboy#busboy-methods).
+
+```js
+fastify.register(require('fastify-multipart'), {
+  limits: {
+    fieldNameSize: 100, // Max field name size in bytes
+    fieldSize: 1000000, // Max field value size in bytes
+    fields: 10,         // Max number of non-file fields
+    fileSize: 100,      // For multipart forms, the max file size
+    files: 1,           // Max number of file fields
+    headerPairs: 2000   // Max number of header key=>value pairs
+  }
+});
+```
+
+If you do set upload limits, be sure to listen for limit events in the handler method. An error or exception will not occur if a limit is reached, but rather the stream will be truncated. These events are documented in more detail [here](https://github.com/mscdex/busboy#busboy-special-events).
+
+```js
+function handler (field, file, filename, encoding, mimetype) {
+
+  file.on('limit', () => console.log('File size limit reached'));
+
+  file.on('partsLimit', () => console.log('Maximum number of form parts reached'));
+
+  file.on('filesLimit', () => console.log('Maximum number of files reached'));
+
+  file.on('fieldsLimit', () => console.log('Maximim number of fields reached'));
+
+}              
+```
+
+
+
 ## Acknowledgements
 
 This project is kindly sponsored by:

index.js

@@ -40,7 +40,12 @@ function fastifyMultipart (fastify, options, done) {
 
     const req = this.req
 
-    const stream = new Busboy({ headers: req.headers })
+    const busboyOptions = { headers: req.headers }
+    const keys = Object.keys(options)
+    for (var i = 0; i < keys.length; i++) {
+      busboyOptions[keys[i]] = options[keys[i]]
+    }
+    const stream = new Busboy(busboyOptions)
 
     req.on('error', function (err) {
       stream.destroy()

test.js

@@ -16,12 +16,12 @@ const crypto = require('crypto')
 const filePath = path.join(__dirname, 'README.md')
 
 test('should parse forms', function (t) {
-  t.plan(12)
+  t.plan(14)
 
   const fastify = Fastify()
   t.tearDown(fastify.close.bind(fastify))
 
-  fastify.register(multipart)
+  fastify.register(multipart, {limits: {fields: 1}})
 
   fastify.post('/', function (req, reply) {
     t.ok(req.isMultipart())
@@ -32,6 +32,8 @@ test('should parse forms', function (t) {
     })
 
     mp.on('field', function (name, value) {
+      t.notEqual(name, 'willbe', 'Busboy fields limit ignored')
+      t.notEqual(value, 'dropped', 'Busboy fields limit ignored')
       t.equal(name, 'hello')
       t.equal(value, 'world')
     })
@@ -41,6 +43,7 @@ test('should parse forms', function (t) {
       t.equal(field, 'upload')
       t.equal(encoding, '7bit')
       t.equal(mimetype, 'text/markdown')
+      file.on('fieldsLimit', () => t.ok('field limit reached'))
       var original = fs.readFileSync(filePath, 'utf8')
       file.pipe(concat(function (buf) {
         t.equal(buf.toString(), original)
@@ -70,6 +73,7 @@ test('should parse forms', function (t) {
     var rs = fs.createReadStream(filePath)
     form.append('upload', rs)
     form.append('hello', 'world')
+    form.append('willbe', 'dropped')
     pump(form, req, function (err) {
       t.error(err, 'client pump: no err')
     })